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WIN! MARTY THE ROBOT V2 UP FOR GRABS! 


10 MILLION+ PRODUCTS ONLINE | 1300+ INDUSTRY-LEADING SUPPLIERS | 100% FRANCHISED DISTRIBUTOR 


SHIPPING 


ON ORDERS OVER 
£33 OR $50 USD* 


Mle Cazes NUN 


*A shipping charge of £12.00 will be billed on all orders of less than £33.00. A shipping charge of $18.00 USD will be billed on all orders of less than $50.00 USD. All orders are shipped 
via UPS, Federal Express, or DHL for delivery within 1-3 days (dependent on final destination). No handling fees. All prices are in British pound sterling or United States dollar. Digi-Key 
is a franchised distributor for all supplier partners. New products added daily. Digi-Key and Digi-Key Electronics are registered trademarks of Digi-Key Electronics in the U.S. and other 
countries. © 2021 Digi-Key Electronics, 701 Brooks Ave. South, Thief River Falls, MN 56701, USA 
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WELCOME 
to The MagFP1 108 


verybody likes to get a gold star. I remember hosting awards 
and no matter how cool they try to play it, getting a shiny 
gong always puts a smile on somebody's face. 

And sometimes it feels right to say ‘well done!’ That’s why this 
month we’ve gathered together the best Award-Winning Makes 
(page 30). These are the projects that have won shiny statues, 
gathered plaudits, and impressed some judges. 

These builds are worth your time. They deliver ideas for your next 





Lucy 
Hattersley 





Lucy is editor of 


make and stand as glittering examples of Raspberry Pi making the Diesen eis 

world a better place. to Cambridge with 
If you want something more down-to-earth and buildable ‘right peat 

now’, then I suggest PJ’s new ‘Ultimate Home Server’ tutorial @LucyHattersley 


(page 38). This is the first in a new series of using Raspberry Pi in the 
home to manage all of the digital files in your life. 

And if you’ve ever fancied yourself making visual entertainment, 
then check Make Games with Raspberry Pi (page 71). In this article, Gey 
Mark Vanstone reveals Raspberry RASPBERRY PI 
Pi software designed to help your —all ZERO W KIT 
digital dreams become reality. 

There is a lot to discover in this 
month’s edition of The MagPi. 
Dive in and discover the idea for 
that project that will one day, 
perhaps, win you an award. 






Lucy Hattersley Editor 


WIRE MARTY THE ROBOT ¥2 TP FOR GRABS! 
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Subscribe to The MagPi, HackSpace magazine, or Custom PC. Your first three Issues for £10, then our great value rolling subscription 
afterwards. Includes a free voucher for one of five fantastic books at store.rpipress.cc/collections/latest-bookazines 
UK only. Free delivery on everything. 
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DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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with your Raspberry Pi 


Power your projects with computer vision and applied AI 


pi-top [4] Robotics Kit comes with electronic components such as a wide-angle 
camera, servos and motors, all of which plug and play with the pi-top [4] 
Complete or pi-top [4] DIY Edition". 





pi-top Robotics Kit with Expansion Plate 


£187.90 / $199.90 
ay a 
| } 
ey ay 
Gesture fo] 5X3 Ke fal (<) Autonomous 
Control Avoidance Driving 
Object Emotion Line 
Recognition Mapping Recognition | _ 
a Integrated 
NA; with Microsoft 
Int ti Face 
nteraction Tracking 





pi-top.com/MagPi 


Raspberry Pi is a trademark of the Raspberry Pi Foundation. ‘pi-top [4] and Robotics Kit with Expansion Plate sold separately. © CEED Ltd. 2021 


Raspberry Pi made simple, robust and modular. 
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Callisto II 


A retro gaming fan gave his Raspberry P! ag 1980s 
makeover, Rosie Hattersley is on the case 











Kevin Solar 


Game developer 
and software 
engineer Kevin 
loves designing 
physical builds 
and often uses 
the powerful 
capabilities of 
Raspberry Pi in 
his projects. 


magpi.cc/ 
solarcomputers 
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Kevin loves to tinker with all things retro: “I like 
to design new NES games using 6502 Assembly” 
he tells us, deftly setting the scene for how his 
Callisto II retro computer design came about. A 
hardware-based project, Callisto marries Kevin’s 
enjoyment of 3D design and printing and his abiding 
love of retro gaming. 

“Tt started in 2019 when | really wanted to 3D-print 
a full-sized retro or a terminal style of computer,” 
says Kevin. “When I was looking all over the web, I 
was surprised that this sort of thing didn’t exist. I saw 
lots of mini 3D printable retro computers and they 
were really good, but I wanted a full-size one that I 
could use for everyday tasks. Since this didn’t exist, I 
had to make one.” 

Raspberry Pi was the obvious choice for the 
hardware to power his dream of recreating the look 
and feel of a1980s computer. “I needed a desktop 
OS to make my retro computer very functional,” he 
explains, “land] Raspberry Pi is an inexpensive and 
very capable computer.” 

Kevin has previously designed two retro computer 
cases. The first, Callisto J-29, “was very rough around 
the edges” while the second one, Europa, “was too 
heavily inspired by the original Macintosh.” For 
Callisto II he wanted to top these first designs and 
“make something that was very easy to print and 
assemble, but still looked great.”” He wasn’t prepared 
to compromise on computing power either - hence 
his choice of Raspberry Pi. 


| n his spare time, games developer and maker 





Tricky curves 

Despite his experience with 3D printing to date, Kevin 
says the trickiest part of the design was modelling the 
curves, as he’d not done this before. He persevered, 
knowing the curves would set his design apart from 
others. It was also a challenge to find a true 4:3 LCD 
screen that was inexpensive and readily available, 

he says, but rarer still to find a retro computer that 
used the 16:9 aspect ratio of modern displays. He was 
eventually able to source an 8-inch Pimoroni display 
to give Callisto that all-important 1980s look. 
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mark an evolution in Kevin's retro 
computer designs - all available 
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Kevin set up a 
retro website 

to accompany 
Callisto’s launch 


He also wrote a 
retro-style 
user Manual 


And an online OS 
(magpi.cc/ 
pigeonos) 


He's particularly 
proud of Callisto’s 
3D-printed hatch 


“| love the way it 
integrates with the 
case, he beams 


Callisto I, | me 
































Ms Magi | PROJECT SHOWCASE 


A Kevin has even 
designed a retro 
online operating 
system for Callisto 





Callisto’s design is inspired by several real retro 
computers such as the ADM-3A, Zenith Z-89, and 
Hazeltine 1500, but with no 3D-printable, full-size 
retro computers available online for comparison, 
Kevin was on his own when it came to working out 
the dimensions and 3D design. 


Easy ethos 
Kevin tried to use readily available parts from 
online retailers for most of the project. “Not only 
did I want this to be super-easy to print and put 
together, I wanted it to be easy to find the parts 
[and be] something you could put together for an 
easy weekend project (assuming you spent the 
previous week printing all the parts),” he says. 
You don’t even need glue as all the parts have 
“been designed to snap together, but you should 
m Callices Ihigiae wire ensure all the electronics have room to breathe, 
3D-printed retro computer 
Kevin has designed he cautions. 








A Atrio of Callisto 
Il computers 
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A 3D-printed parts ready 
for assembly 


V As Callisto Il is 3D-printed, 
you can have it any colour 





™ Something you could 
put together for an easy 
weekend project @ 


The project cost roughly $250 and involved 
printing six parts on a Prusa Mini 3D printer that 
each took a day to print. When sourcing a suitably 
tactile 60% mechanical keyboard, Kevin suggests 
choosing one that has blue switches. “These give 
the loudest clicks,” he says. 

Kevin stuck with Raspberry Pi OS, but part of 
Raspberry Pi’s appeal is that you can load games 
and emulators to make it look and run however 
you want, he says. RetroPie is an obvious choice 
here. For more ideas on mimicking Callisto’s retro 
looks with retro programs, take a look at Retro 
Computing in The MagPi issue 88 (magpi.cc/88). 
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Build a retro computer 


Download and 3D-print the parts for your Callisto II 
from magpi.cc/callisto2. The case is designed to 
snap together with pins; glue is optional. 





01 Assemble the case and install the hardware. 
The screen should easily slide into place 
using the case's built-in slots. 


ip Slot the keyboard in place, followed by the 
USB hub and power supply. Secure them 


using 3D-printed pins. 


SHIM! 


0 Insert and plug in Raspberry Pi near the PSU 
and, optionally, secure it using Velcro, then 
power up your retro computer. 
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There's one major 
component to the setup, 
which is the PIR sensor 


mousetrap 


Safely catching mice is a better way of fixing a problem, and using 
Raspberry Pi means it needs less supervision, Rob Zwetsloot takes a look 


ith some IoT projects, it’s the little 





| things that help. For example, take 
oe Andrew Taylor, who did the good thing 
=> of setting up a humane mousetrap. However, 
Ii checking it to see if any mice had been caught in it, 
é ee while necessary, was getting a little boring. 
ee “Tf a mouse had gone in and | did not check 
it, the mouse would quickly run out of food and 
Andrew Taylor water!” Andrew tells us. “Having been interested 


in Raspberry Pi for a couple of years and having 
A web developer ‘eh 1 : Purh ; Fe Hasieoe 
Sie ia cand recen y begun learning 2 on using the nviro 
a Raspberry Pi, environment sensors, | figured a Raspberry Pi with 


allowing him to a motion sensor would be an ideal way to check.” 
reconnect with the 


It’s a fairly simple setup, one commonly used in 
basics of computing } ; ; 
that got him CCTV builds and some fun ‘parent detectors’ on the 
interested in the Raspberry Pi Foundation’s projects site. 


first place. 


Mouse motion 

“T came across a couple of automated mousetraps 
that people had made from scratch, but wanting 
to keep it simple and cheap,” Andrew explains. “I 


Pei 
An old coffee tub is used 


as a case for the sensor, 
a good way to recycle 
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The whole setup 
costs roughly £28 


At the time of 
writing, Andrew 
has safely caught 
three mice 


Camera modules 
can detect motion 


The detection rate 
is calibrated to 
the environment 





Don't fill your trap 
with cheese 
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A Wiring up the PIR to Raspberry 
Pi is quite simple, and means the 


al project is easy to maintain 


™ | came across d couple of gutomated mousetraps that people had made 
from scratch, but wanted to keep it simple and cheap @ 





~ 





wanted to use off-the-shelf parts where possible 
and keep costs down. The Pi Hut had a tutorial for a 
DIY burglar alarm utilising a PIR sensor, IFTTT, and 
Pushbullet, which seemed like an ideal starting 
point (magpi.cc/pihutifttt).” 

IFTTT - If This Then That — is an online service 
popular with IoT folks. It’s great for small things 
like cross-posting images on social media services, 
or sending a push notification when motion is 
detected in a mousetrap. 

“T have only had one mouse since, but it worked!” 
Andrew says. “I was averaging about 800 detections 
a day and suddenly got well over a1000. Sure 
enough, there was a mouse in the trap which I 
released shortly afterwards. I do tend to notice 
that the values fluctuate a bit, so it is always worth 
checking over the previous day’s results to see if it 
is notably higher.” 

You might think that 800 push notifications a 
day is far worse than just occasionally checking 
your garage, and you’d be right, so Andrew tweaked 
the code a bit: “The code examples I found sent a 


x. 5 






A It’s a simple design, 
‘ and was kept simple to 
keep to a small budget 
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Catching mice 


























01 The setup stays on 24/7, and monitors the 
PIR sensor for movement. The PIR uses 
infrared so it works just fine even in the dark. 
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ip Movement is tracked using a Python script 
which checks, and logs, every 30 seconds. This 
allows for more accurate long-term readings. 


notification for each movement detection — which A The first successful capture 


was released back outside 


I knew would be rather annoying, considering how 
the garage 


randomly PIR sensors sometimes seem to trigger. 
My script instead logs any hits at a max of 1 per 30 
seconds and then triggers a notification once every 
24 hours, meaning I just get one notification a day.” 


SUT OU, Pool pm 


Motion Detection Report 


June 10, 2021 at 11:50PM - 1117 
occurrences in the last 74.0? hours 





Beat a path 
There’s always room for improvement, as Jun 12, 12:09 am 
Andrew explains: “I intend to improve the code 

so that it can record running averages and give 

an indication as to whether it believes there has 
been a significant spike that might necessitate me 
checking it out.” 

Whilst the aim of the project was to keep costs 
down, Andrew is tempted to experiment by adding 
a camera, and possibly a light, so he can have a Pushbullet,” says Andrew. “This then sends this 
peek remotely when there has been a spike in the message as a notification to my phone. The counter is 
readings and to see if it is a false alarm. Which, as then reset ready for the next day." 
he admits, is “a new height in laziness!” 


Motion Detection Report 


June 12, 2021 at 12:09AM - 994 
occurrences in the last 74.32 hours 






03 “After 24 hours, it triggers a message containing 
the number of hits over that period by sending 
a HTTP request to IFTTT which is hooked up to 
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Bop It 


Minecrait 
Controller 


Why play Minecraft with a keyboard and mouse when 
you can use an electronic toy modified with Raspberry 
P| Pico? Nicola King appreciates the twist 





Seth Altobelli 





Seth is a student 
studying robotics 
engineering who 
enjoys making videos 
on projects that 
combine electronics, 
software, and 


mechanical elements. 


magpi.cc/ 
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toys, Bop It has been around for 25 years. 
Normally, you press, pull, flick, spin, 
and twist its buttons and knobs according to the 
spoken instructions given. Great fun, if noisy and 
annoying for parents. Seth Altobelli, however, 
opted to refit his Bop It with a Raspberry Pi Pico to 
turn it into a USB controller for Minecraft. 

He was inspired to create the project by two 
prominent YouTubers. “Michael Reeves made a 
video using a Bop It as an alternative interface to 
Hawaii’s nuclear alert system. This inspired me 
to use a Bop It, or similar device, as an input for 
something it was not designed for,” he says. 

“Another creator, Technoblade, has an old 
video where he beat Minecraft hardcore, the most 
challenging difficulty, with a steering wheel. I was 
watching this a while back and then the idea of 
playing Minecraft with a Bop It just came to me.” 


0 ne of the world’s favourite electronic 


Buttons to Pico to USB 

To turn his Bop It XT into a controller, Seth first 
took the case apart and removed the existing PCB, 
replacing it with a Raspberry Pi Pico. All of the 
Bop It’s controls link to simple momentary push- 
buttons, which meant he could simply wire these 
to digital GPIO inputs on Pico. 

When an internal push-button is pressed, it 
triggers Pico to send the corresponding keyboard 
command over USB. “Pico can act as a USB device, 
meaning, as far as the computer running Minecraft 
knows, it is anormal keyboard,” he tells us. 

In addition to the button inputs, he installed an 
accelerometer in the Bop It. This connects to Pico 


16 | magpicc | Bop It Minecraft Controller 


Minecraft is a little 
trickier, but perfectly 
folks Wale] (ome tilare masala 
customised Bop It 





over 12C. “[Pico] reads the acceleration vector, 
does some simple vector math, and uses that to 
send mouse commands over USB,” explains Seth. 
“The fact that Pico can so easily be programmed 
to act as a Keyboard and mouse at the same time 
made this project possible.” 


Develop and debounce 
The project took Seth two days to develop. “The first 
day I opened the Bop It, analysed how the inputs 
interface with the control board, wired the circuit, 
and wrote a basic program to make sure my wiring 
was correct,” he recalls. 

“The next day, I wrote the main control program. 
I then played Minecraft with it and made minor 
changes over the next few days when I had a few 
hours free.” 

The most challenging element for Seth was 
the programming as, although an accomplished 
Python coder, he was using CircuitPython for the 
first time. “That said, it made the USB functionality 
surprisingly easy.” 

The trickiest part of the program was the 
debounce timers he had to code for each button, 












The main button is used ce, 
to switch between camera 

and walk modes, with tilt 

foxoyalige) mela ante -laal-vale 
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M Pico can be programmed 
to dct as a keyboard and 
mouse at the same time @ 


to ensure they only trigger once each time they’re 
pressed. “This was especially important for the 
buttons that moved in the hotbar and the right- 
click button that is used for eating and placing 
blocks,” he notes. “The Bop It made this difficult 
as some of the buttons are challenging to quickly 
press, meaning the code would toggle them 
multiple times as though they were being held 
down. If I] increased the timer too much, it would 
limit the frequency I could press them. I was 

able to get all the timers to work, but it did take 
some fiddling.” 

The end result works surprisingly well for 
playing Minecraft, as demonstrated in his YouTube 
video (magpi.cc/bopityt) — particularly the tilt 
control for movement, Wii Remote style. Not bad 
for a project he describes as being “made as a joke 
from the start.” Wl 


By replacing its PCB 
with a Pico, the Bop It 
ors] alu oX- mo) cele |e-lanlani=re mike) 
We) dare Obs) = Rexel alige)it=ig 


A Each of the Bop It's internal push-buttons is connected to a digital 


input on Pico, which is held in place using a small 3D-printed mount 


> 
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HN) Quick FACTS 


Seth has offered 
to send his 
custom Bop It to 
Technoblade to 
try out 


This is Seth's debut 
project using any 
Raspberry Pi device 


Combinations of 
buttons are used 
for some actions in 
the game 


A small MPU6050 
accelerometer/ 
gyroscope board 
enables tilt control 


Seth cut a hole 
in the speaker 
grille to fit Pico's 
micro USB port 
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PrivacyMic 


A device that listens to noises in your home but 


doesn't hear your conversations? David Crookes tunes in 








Yasha 
lravantchi 


Yasha Iravantchi is 

a PhD candidate 

at the University 

of Michigan. He 
researches novel 
sensors that 
operate in a privacy- 
preserving way. 


magpi.cc/ 
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ore than 320 million smart speakers 
have been sold across the world, 
allowing us to use our voices to play 
music, ask questions, and discover information. 
A growing number of Internet of Things 
(loT) devices are also being embedded with 
microphones, but there are concerns they’ re 
capable of eavesdropping on our conversations 

“Tt’s hard to tell what an IoT device is doing 
with its microphone beyond an LED signifying 
its microphone is in a muted or unmuted state,” 
says Yasha Iravantchi, a graduate student at the 
University of Michigan. “In the future, these 
devices are going to perform more tasks than just 
listening for speech commands and there is the 
possibility that a lot of audio will be captured, 
recorded, and stored.” 

For this reason, Yasha has been leading a team 
developing PrivacyMic, a research project ensuring 
private conversations cannot be recorded and 
stored. By only gathering sound at frequencies 


PrivacyMic 


A This laptop is running the team's own open- 
source app T4Train which can connect to 

PrivacyMic and train a model on the spot using 

incoming data, or load a pre-trained model 





above the range of human hearing, the system 
filters out speech and audible sound, yet can still 
understand what’s happening in our environment. 


Sound of silence 
PrivacyMic is built around Raspberry Pi and it 
works with ultrasonic sounds — that is, those 
with a frequency of 20 kilohertz or higher. Many 
objects and actions emit ultrasound waves, 
including compact fluorescent bulbs, dishwashers, 
computer monitors, flushing toilets, and electric 
toothbrushes. “It’s a frequency that’s inoffensive to 
humans, but can be annoying to dogs,” says Yasha. 

Most traditional audio equipment won’t capture 
ultrasonic sounds. “Devices are tuned to focus on 
the range of human speech or hearing and they 
often actively remove the sounds outside of these 
ranges as ‘noise’ from the environment,” Yasha 
explains. By creating a HAT for Raspberry Pi Zero W 
using an analogue ultrasonic microphone anda 
filter to remove speech and audible frequencies, 
however, PrivacyMic can do the opposite. 

“The ‘noise’ that these systems throw away 
is a valuable signal we can use to recognise 
and classify daily-use objects,” Yasha says. It 
means PrivacyMic can hear when a light bulb 
Or Microwave is turned on, determine when a 
toothbrush is being used, or when a toilet is 
flushed, without capturing any conversations. 
“We’ve also been using Raspberry Pi 3 to explore 
ways of performing all tasks - from capture to 
classification — on the computer itself to ensure no 
data ever leaves Raspberry Pi.” 


Listen up 

So how does it work? “Analogue filters remove 
the audible frequencies and only allow ultrasonic 
frequencies to pass through to the analogue-to- 
digital converter (ADC),” Yasha explains. “These 
signals are passed to a machine learning model 
to recognise these daily-use objects in ultrasound 


MagPi 


In a demo, PrivacyMic was shown to 
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using a small servo that physically 

presses the button, allowing for 
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PrivacyMic 
only listens for 
frequencies 

of 16KHz+ 


Sound has been 
| collected from 
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inoffensive to humans, Dut determine what device is being used 
a can be annoying to dogs 


The team has 
applied for 
patent protection 








only, and the model then records an entry, 
including a time stamp and the name of the thing 
that turned on.” 

In doing so, the filtered ultrasound is not 
kept. “The idea is that there are multiple layers 
of safeguards in place that allow us to minimise 
the privacy exposure to users while Keeping the 
artefacts that matter. In the case of activities of 
daily living tracking, it’s the activity log, not the 
sounds themselves that are of value,” Yasha says. 
Accomplishing this has entailed a lot of coding. 

C is used to efficiently send samples from the 
ADC to a laptop via TCP, and a new framework for 
interactive machine learning has been developed 
in Python. “It’s called T4Train (magpi.cc/t4train) 
and it’s a work-in-progress, but it’s already 
compatible with Raspberry Pi,” Yasha says. 

Even so, work is far from complete. “One of the 
hardest challenges is trying to train PrivacyMic to 
learn to recognise sounds that you yourself cannot 
hear,” Yasha laments. It means the device won’t 


likely be out of the proof-of-concept stage for a ie é 
) The PrivacyMic HAT connected to Raspberry Pi Zero. 

Tew eats Yer) but we ll keep our ears to the eee A 250kHz low-pass filter is needed by the 500kHz 

for more news as the project progresses. ADC to remove high-frequency interference 
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Campervan L. 


Needing to travel to several countries for work, one 
maker chose to kit out his campervan as a mobile office, 
Rosie Hattersley was intrigued 





Enrico Miglino 





Enrico designs and 
develops multi- 
platform software 
projects for clients 
across Europe 
(and occasionally 
India). He's been 
using and helping 
road-test Raspberry 
Pi since its first 
Linux prototype. 


we-are-borg. 
com 


they offer a chance to escape the home in 

favour of fresh air and a change of scene. 
Enrico Miglino’s job often needs him to pitch up 
in Germany, Spain, or Belgium where his software 
development architect consultancy is in demand, 
so it made sense for him to take the digital nomad 
concept literally, and adapt a campervan to create a 
mobile office. 

Although most campsites and caravan parks 
offer WiFi to guests, such connections are often 
unsecured, limited to only a couple of hours’ free 
use, and require each device to log in separately. 
Enrico needed a setup that was far more robust. 
His vehicle, Jan The Van, sports a secure mobile 
LAN, is powered by three Raspberry Pi computers, 
and allows Enrico to use a single login to provide 
internet access to any devices on his network. The 
whole setup cost less than 500 euros, meaning he 
could also afford to add a solar panel. 


C ampervans are all the rage right now, since 


Hack The Van 


Enrico bought his van specifically for use as 

a mobile office. “The project aims to create a 
modular set of technological improvements in 
a standard vehicle to convert it to a secured and 
efficient mobile unit for living, working, and 
travelling,” he explains. 

It’s named after Enrico’s friend Jan Cumps who 
helped him work out the electronics that would be 
needed to successfully hack the van. The pair spent 
many evenings working together studying how 
to develop projects, debug hardware circuits, and 
teaching workshops at the Ingegno Makerspace in 
Ghent in Belgium (ingegno.be). 
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> Enrico has an 
original Raspberry 
Pi prototype 


> He participated in 
the design of its 
first Linux distro 





> He loves Raspberry 
Pi for its flexibility 
and adaptability 


>» Amodular 
approach means 
project components 
are readily reusable 


> The biggest Jan 
The Van challenge: 
space, of course 
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A Jan The Van - a mobile 


office with a constantly 
changing landscape 


WV Aaquick glance inside 
and Jan seems like 
a relatively normal 
luxurious Campervan 





| WH j/ 
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The duo took a modular approach to the build, 
starting with an 8GB Raspberry Pi 4B mounted 
in a case with a 7-inch touchscreen. Developed 
with Node-RED, the display shows the state of the 
network, firewall status, and the local weather. 

It also has screens monitoring any physical 
intrusions around Jan The Van. 

DHCP features and the wireless LAN to Ethernet 
router make it safe for Enrico to connect his 
shielded network to insecure public WiFi networks. 
He’s currently adding sensors to monitor gas and 
smoke levels from the van’s kitchen, and to show 
how much water he’s storing on board, providing 
reassurance there are plenty of provisions on 
lengthier, more remote journeys. 

Enrico found lots of ideas online for how to 
create his vision, building and testing each 
element before installing it. “I tried to design it to 
be as modular as possible so it’s easy to replicate it 
and adapt the modules to similar but not identical 
environments,” he says. 


More Raspberry Pi 

Internal devices on Jan The Van’s network could 
only be connected to the Ethernet port, which 
wouldn’t work for iPads, iPhones, and other mobile 
devices that lack the necessary port. To overcome 
this, Enrico added an Ethernet switch and a second 
Raspberry Pi 4B configured as a bridge to which 


] A 


LALANAAANS 


Jan The Van's third 
passenger reportedly 
enjoys the ride 








| tried to design it to be as modular as 
possible so It's easy to replicate it and 


qdapt the modules 


these mobile devices can connect wirelessly. A 
third Raspberry Pi connected to a full HD webcam 
provides live visuals of the rear of the vehicle while 
he’s driving, and acts as a motion sensor security 
camera when the campervan is parked. It “detects 
motion around the camera field of view and records 
video just in case,” Enrico says. 

Jan The Van’s first big trip was a ten-day journey 
from Belgium to a “nice campsite” in Spain — 
some 2800 km — where Enrico easily hooked up 
his campervan LAN and was able to work as a 
consultant each morning and tinker with his mobile 
office setup each evening. Planned improvements 
include adding a third Raspberry Pi 4 with a display 
to stream images from the van’s rear camera and 
other information to the dashboard or cockpit. 
Most important, says Enrico, “is travelling to nice 
places to test the prototype in the real world.” 





Warning! 
Electric hookup 


Be careful when adding 
a power inverter to a van 
for electric hookup and 
seek professional advice. 


magpi.cc/ 
powerinverter 


MagPi 


Hack your van 





To create your own campervan network, you'll 

need two Raspberry Pi 4 computers for the 
LAN, one of which acts as a wireless bridge to provide 
ad hoc access, and a 300W or less power inverter. 
Laptops can also connect via Ethernet. 





The main interface uses Node-RED software to 

manage the hardware, with C/C++ to program 
the ESP3266 modules attached to the sensors. The 
screen orientation is corrected in configuration. 





Enrico used Python bash scripting to manage 

the network, execute timed tasks, and 
automate image saving from the on-board camera. 
This can be either a webcam or a Raspberry Pi 
Camera Module. Full details of Enrico's hack the van 
project are at magpi.cc/janthevan. 
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Air Quality 





Tratfic Light 


Worried about the effects of poor dir in his home city, Dmytro Panin 
has created g unique alert system, as David Crookes explains 





Dmytro Panin 





Dmytro Panin is a 
programmer based 
in Kyiv, Ukraine, and 
he wrote his first 
line of code aged 
eight. He works for 
a large provider of 
nearshore software 


engineering services. 


magpi.cc/ 
airquality 


> The traffic light is only 
used during the day. 
It's been coded to turn 
itself off at night, but 
can be activated for 
a minute by pressing 
the button on top 


polluted cities. It has high smog levels, 
which can cause health problems. “It also 
occurred to me that, in summer, the air quality 
in Our area can deteriorate due to peat deposits 
igniting and smouldering somewhere in the 
province,” says Dmytro Panin. 
For that reason, he decided to take a break from 
a project he was working on — a device which 
monitors currency prices using Raspberry Pi Zero W 
— to create an air quality reporting system. Having 
found a battery-operated toy traffic light, he came 
up with a plan that was both practical and fun. 
“Tf the wind blows in the direction of the 
city, you can smell the smoke, which some say 
resembles whiskey, and it means you don’t want to 
have the windows open for too long,” Dmytro says. 
“So, | came up with the idea of having the red light 
of a traffic light illuminate if this was to happen.” 


K yiv in Ukraine is one of Europe’s most 


Capturing air quality 

Dmytro chose a traffic light made by German toy 
manufacturer Dickie. “It’s compact, has a button 
on top, and two additional LEDs accompanying 

the standard three,” he explains. But before he 
could connect it to a Raspberry Pi 3B+ computer, he 
needed to open the toy. 

“T had to get rid of the traffic light’s internal 
components without damaging the LEDs or the 
internal structure of the toy,” he continues. “TI also 
had to change the resistors so that it would work 
with Raspberry Pi’s GPIO pins, which produce 3.3 V.” 

From there, it was a matter of working out 
the best way of capturing air quality, starting 
by experimenting with the MQ-135 gas sensor 
which monitors benzene, alcohol, and smoke. “I 
got it working after a few hours by connecting an 
additional analogue-to-digital chip to the serial port 
of Raspberry Pi,” he says. “But the measurements 
were not that precise and I had to write quite a bit 
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of code to account for inaccuracies which varied 
drastically based on the environment temperature.” 


Good to go 

Instead, he turned to an MH~-Z19B carbon dioxide 
sensor. “It was way more accurate and it worked, 
but only temporarily, as the elements in my area 
can be on the extreme side,” Dmytro says. 

The solution, therefore, was to write a short 
program using the open-source programming 
language Go (golang.org). It fetches Air Quality 
Index data from the website IQAir (iqair.com), 
which uses information from consumer devices 





A Raspberry Pi 3B+ has been used. “This would 
usually be overkill for a project like this, but it 
runs the Samba server, the tracker-blocking 


Pi-hole, and MariaDB 24/7," Dmytro says 
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™ The aggregated data 
IS guite accurate, But It 
covers the entire city @ 


located across Kyiv. It also grabs current data from 
OpenWeather (openweathermap.org) in parallel. 

By storing the data on Raspberry Pi, Dmytro’s 
Script — written in Python — can determine which 
light to illuminate, controlling the LEDs using the 
Python library GPIO Zero. Red obviously shows 
that the air quality is poor, prompting Dmytro 
to close the windows and take precautions when 
venturing outside. 

Even so, there is room for improvement. “The 
aggregated data is quite accurate but it covers the 
entire city,” he laments. “Sometimes it would 
make more sense for measurements to be more 
local. Collecting data myself and combining it with 
the information | get from the API should be the 
next step.” 
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> The traffic light 
can be bought for 
about £10 


> Its 12 centimetres tall 


> The project uses 
a Raspberry Pi 


3B+ computer 
Dmytro has placed Raspberry Piina 


LEGO-compatible case. A 3D-printed 
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the AWS Lambda symbol. Dmytro says: 
“It used to be our team’s mascot” 
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> Raspberry Pi Zero 
would also work 
perfectly well 






>» Allthe files are 
on GitHub 
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A Data from IQAir is used to help determine which LED should illuminate on the traffic light 
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Kenbak-2/5 


Reproducing 0 personal computer that was first created way back in 1971 
has been, for Michael Gardi, a labour of love. Nicola King turns Back the years 





Michael Gardi 





A retired software 
developer, living in 
Waterloo, Ontario, 
Canada with his wife, 
who appreciates 
having the time to 
make whatever the 
heck he damn well 
feels like! 


magpi.cc/mgardi 
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A Raspberry Pi 4 is connected to the lights and LEDs 
on the front panel via a 32-channel I/O expansion HAT 


egular readers of The MagPi may recall that 
= in issue 102 (magpi.cc/102), we covered a 

fantastic Turing machine reproduction by 
Canadian retro enthusiast Michael Gardi. Well, 
Michael is back with another blast from the past - 
this time with his take on the Kenbak-1 which, as 
he shares, was “considered by many to be the first 
commercial personal computer, despite its failure 
in the marketplace.” 

The Kenbak-1 was created by John Blankenbaker, 

a computer engineer and inventor, and Michael 
was drawn to the idea of reproducing it in the 
form of the Kenbak-2/5 (a 2:5 scale model of the 
original) for a key reason. “For me, the thing 
that attracted me to this project, aside from the 
historical significance, was the sophisticated 
instruction set that the Kenbak-1 supported,” 
he explains. “This was surprising because the 
computer was implemented with discrete logic 
chips and did not contain a microprocessor. 
The instructions were on a par with those used 


A Aclose-up of the wiring from the 
HAT: most of the channels were used 





in microprocessors that were to follow years 
later, like the Motorola 6800 (1974) and the MOS 
Technology 6502 (1975).” 


A contemporary take 
Michael has a YouTube video (magpi.cc/kenbakyt) 
that explains in detail how the original computer 
worked, as he enters a program through the model’s 
front panel buttons. He then details how the 
Kenbak-2/5 supplements the original by allowing 
the user to enter a program by typing in assembly 
language instructions. In Michael’s words, his 
version of this computer “allows one to have a 
‘classic’ Kenbak-1 experience, then enhances that 
experience by allowing the user to use more modern 
tools like an assembler and a debugger.” He also has 
a detailed Hackaday page (magpi.cc/kenbak), if you 
feel like having a go yourself. 

Using photographs of the original machine as 
a guide, because finding an original Kenbak-1 
would have been difficult and hugely expensive, 
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is overlaid with a clear acetate 
sheet featuring button labels 


1 | think that the devices themselves, and thelr designers, Quick FACT 
deserve to be remembered and honoured & Jenn eo cine 


Michael 3D-printed the frame of the project. 
“One of the reasons that I chose to make this 
reproduction at 2/5 (40%) scale was so that all 

the 3D-printed parts (of which there were only 
five) would fit onto my printer. So, this simplified 
the assembly,” he says. “Aside from the screws 
used to mount the Raspberry Pi to the frame, 
everything just snaps together.” 

A built-in Raspberry Pi 4 is connected to the 
front panel via a 32-channel expansion HAT. It 
also runs an IDE that can be accessed on a remote 
machine via SSH or VNC; the source code is on 
GitHub (along with the STL files for 3D printing the 
case): magpi.cc/kenbakide. 

Michael created the Kenbak-1 Assembler and 
Emulator using Python and it’s all based on John 
Blankenbaker’s Programming Reference Manual. 
Any qualms he had about his understanding of 
the documentation were laid to rest by fellow 
enthusiasts who helped him out with potential 


original Kenbak-1 


: « i | 
glitches. “Fortunately, there is a pretty active computers were 


Kenbak-1 community out there and some people 





ever sold 
actually tried out my software and found a few bugs 
and misunderstandings. 7 > As they are so rare, 
the last one sold 
Architect's approval at auction went 
The icing on the cake is that Michael’s make has for $40,000 


received praise from the original inventor. “I sent 
John Blankenbaker (91 years young) an email with 
pictures of my reproduction and a few questions, 


>» Michael's version 
took one month 


and he was gracious enough to answer. The first ea 

thing he said in his reply was ‘Your email was the mivseeorine 

most interesting thing | have received today. I was projects are based 

very impressed!’. That sure made my day too!” on very retro 
Praise indeed, and this underlines one of the reproductions. 

reasons why Michael undertook the challenge: 

“T think that the devices themselves, and their > like this impressive 

designers, deserve to be remembered and replica of a 


1968 computer: 


honoured.” Many enthusiasts would certainly 
magpi.cc/vt100 


agree with that sentiment. 
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FROM ONLY £5 
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» FREE Delivery 
Get it fast and for FREE 


» Exclusive Offers 
Great gifts, offers, and discounts 


» Great Savings 
Save up to 35% compared to stores 


» Low monthly cost (from £5) 
» Cancel at any time 

» Free delivery to your door 
VAN ENC ls)(miivoyacohivate (= 


£55 (UK) £90 (USA) 
£80 (EU) £90 (Rest of World) 


Free Raspberry Pi Zero W Kit with 12 Month upfront 
subscription only (no Raspberry Pi Zero W Kit with 
Rolling Monthly Subscription) 





@ Subscribe by phone: 01293 312193 
© Subscribe online: magpi.cc/subscribe 


Email: magpi@subscriptionhelpline.co.uk 
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> Raspberry Pi 
Zero W case with 
three covers 


> USB and HDMI 
converter cables 
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» Camera Module 
connector 


This is a limited offer. Not 
included with renewals. 
Offer subject to change or 
withdrawal at any time. 











SUBSCRIBE 


I 1] 
eT eee tips for it > OF ae 


As AB 
a Sava 

= Available on the 

é Ve) os) ce) c= 


| fm - fe : > : 
i Pp ouy =r S a 

hh — , 0 CES OF PROUECTS Bb PLAS TK, 

PAGES OF PROJECTS & TUTORIALS BS a ; GETIT ON 


> Google Play 


on app stores 





magpi.cc | 29 





ME WiigPi | FEATURE 


AWARD 
WINNING 


" 
i | a 
| \ 
a — | 
a: 


Incredible builds that have won competitions 
and prestigious honours 











e like to hope that at least some of 
W the projects we publish in The MagPi 
inspire people to make more. When 


it comes to inspiration, though, nothing beats 
projects that are changing the world for the a 


better, and have won awards for doing so. 

There are many kinds of awards, and even more 
kinds of winners, but here is just a selection of 
these prestigious projects that will make you go 
‘ooh’ and ‘aah’ in appreciation, and hopefully be 
the spark of inspiration for your next build. 





— 
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Nemo-Pi 
Save Nemo 
magpi.cc/nemopi 


This underwater ‘weather station’ from the Save 
Nemo Foundation is being used to protect coral 
reefs from climate change and divers. 

They work by attaching to a concrete block 
that has been placed on the sea floor - these 
blocks are attached to a buoy that boats can moor 
up to, rather than randomly dropping anchors 
that can damage the reefs. The Nemo-Pi can 
detect temperature, visibility, pH levels, and 
concentration of certain gasses in the water. 

As well as monitoring the ocean, it will allow 
holidaymakers to know if the conditions for 
diving are good. 

Nemo-Pi won the Google.org Impact Challenge 
2018 competition. 


FEATURE | Magi 


Space Vegetables 
feiticeirO 
magpi.cc/spacevegetables 


Our friends over at elementi4 regularly have 
community design challenges that involve 
Raspberry Pi. A recent one, 1 Meter of Pi, 

was to create a1m} area that could grow food 

on a hypothetical trip to Mars. The winner 

was feiticeiro with their Space Vegetables, a 
hydroponic garden that had a time-lapse camera 
and the ability to post to Twitter. 

Like a lot of the element14 competitions, you 
can read a detailed, regular analysis of how the 
build and growing went. To summarise, the 
water, nutrient, and air pumps, along with grow 
lights, were all Raspberry Pi controlled using a 
mixture of sensors and code. The results of this 
cosmic produce has even been sampled. 





KocoypVe-1X-Janmanrevalixel diate) 
Sarab Sethi 
magpi.cc/ecosystem 


“The health of a forest ecosystem can often be 
attributed to how much noise it creates,” says 
Professor Rob Ewers of Imperial College London, 
the university where this project that listens to the 
rainforest was created. 

These solar-powered audio recorders using 
Raspberry Pi were the creation of a small team 
at ICL, including Dr Sarab Sethi and Dr Lorenzo 
Picinali, and are placed around the rainforest in 
Borneo. They record and transmit the noise 24/7 
for scientific study or for you to just chill out to via 
the SAFE Acoustics live stream: magpi.cc/SAFE. 

This system won a prestigious NETEXPLO 
Innovation Forum Award 2018, an award scheme 
from UNESCO that looks at university projects. 


se They record and 
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Coolest Projects Online 2021 


f you’ve read much of The MagPi, you’ ll had to go online, and this has meant not only 
know we love Coolest Projects. It’s an more entrants but also more winners. For 2021, 

event run by CoderDojo that showcases several judges chose their favourite projects out 
incredible projects from younger makers. For of over a thousand entries — here are the ones 
the last couple of years, Coolest Projects has that used Raspberry Pi. 
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magpi.cc/capforblind 


This cap has an ultrasonic distance sensor 
attached to the brim, making a warning noise 
if any objects are within 60cm off the person 
wearing it. It’s supposed to complement a cane 
so) am 0) bb aKely oY=10)0) Comms bb Kel oD ESMUN-Y<16 lm Ko Me (<1 n-1en m0) 0) (<0 8S 
lower down the user’s body. 


BROADCOM CODING WITH COMMITMENT 


Friction experiments made easy 
PN adelam ot-lil-) @celiim celt-lire 
magpi.cc/frictionexp 


School physics lessons like to do practical 
experiments to determine friction on an object. 
Artur created a Raspberry Pi 3B+ box that you 
can place on the object, which not only aids in 
calculating the coefficient of friction, it provides 
a much more accurate measurement. 


JAMES WHELTON’S FAVOURITE 
ADVANCED PROGRAMMING PROJECT 
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MCexeli=Lereleh'] 
Jayanth Ramganesh from the UAE 
magpi.cc/medibuddy 


A system to remotely dispense medicine to 

a patient, as decided by a doctor. A custom 
interface is given to the caregiver, with patient 
info and a button to dispense the medication, 
which is then pushed out of a hole in the 
MediBuddy case with a sound alert. 


JAMES WHELTON’S FAVOURITE 
HARDWARE PROJECT 


Backyard Squirrel Detection System 
Nadim Aatclalemigeliimsal-mery.\ 
magpi.cc/backyardsquirrel 


This project’s full name is ‘A Deep Learning 
Based Backyard Squirrel Detection System 
Utilizing Raspberry Pi’, and it does exactly that. 
Using Google’s Coral Edge TPU, and a squirrel- 
trained deep learning model, Arvin was able to 
warn his grandma of invading squirrels so she 
could protect their peach tree. 


MELISSA PICKERING’S FAVOURITE 
ADVANCED PROGRAMMING PROJECT 








ea thiec] 0) (=m my CLO) 
Steinway Piano 
Lavie from the USA 
nareke] yRxevA -xe Le) ey i=Jare) 


This clever hack takes a LEGO piano 
that is fully mechanically functional, 
and uses a mixture of handmade 
paper PCBs with conductive ink 

and a Raspberry Pi to translate the 
mechanical functions to the notes it 
should play. Lavie had to debug her 
(efoYe (=m Kor (exer len ohamKe) mud atomic hvmennel nage) (= 
keys are pressed in a smart way. 


MELISSA PICKERING’S FAVOURITE 
HARDWARE PROJECT 


Past 
winner 
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helps them pay closer attention to what 
they're eating. It connects to various 
apps via Raspberry Pi. 


BEST INTERNATIONAL PRIZE 2018 
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°° This consumer erade (under 
$100/£72) box can accurately 
detect earthquakes ?” 


—Feladale (ete). (cm tel ana acclaaliace| 
Vivien He from the USA 
magpi.cc/earthquakewarn 


This consumer grade (under 
$100/£72) box can accurately detect 
earthquakes over a magnitude of 3.0, 


and filter out footsteps, jumping, and 


other nearby human activity. It then 
sends a warning to the user’s phone. 
Vivien hopes this kind of tech can be 


used to save lives and reduce damage. 


eco) BS] 74 e008) ia = 
HARDWARE PROJECT 


Door Pi Plus 
ad aXe Le (=) 
magpi.cc/doorpiplus 


A door security system for elderly users 
date lmaatelCosoM 0 (oe) mra\edt=| mi g=recefelalinie) a 
software. This project has won more 
awards as well from other UK and 

fo | Ko) of=| Mexolan)ey=a4) 410) alse 


COOLEST PROJECTS UK 2019 
HARDWARE WINNER 





Vital Signs Monitor 
Adarsh Ambati 
magpi.cc/vitalsigns 


Adarsh's project is a system for 
laatealixe)alale BVA|k=|@si(e]alcmxeme|t-\elaleii=) 

Ut aT=SS-MV/71daleleimxelucevallavemaal=mex-la(-1alm 
It also provides limitless possibilities, 
icolaam ec. -laitiae mie (e(e(-ablaicclalmetcrolag 
Wi alelco)aat=mxemelt-\elaleiiare mul aetsy-ion 


OVERALL WINNER OF COOLEST 
PROJECTS USA 2020 
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Astro PI 


ou can find Raspberry Pi everywhere, 
Y even in space! There are yearly 

oo) nah oX-pa am Coy ekcmomby oy Coy-lemr-belemmebamienl=seler~ 
experiments aboard two special Raspberry 
Pi computers, called Astro Pi, aboard the 





2018/2019 Mission Space Lab 
TheHappy.Pi 


| Liceum Ogolnoksztatc\ce im. Bolestawa 
Cr ATAU oll ti k=Ye fom’! Mt i0] ol-1.40 Mm exe) t-Jale| 


One of the winners from this Mission Space 

Lab were able to process images to measure 
concentrations of chlorophyll concentrations in 
Earth vegetation. You can read about the full list 
of winners here: magpi.cc/ms12019. 





total team 
IU] olaalissielars 


_ 


International Space Station orbiting 408 km 
above the Earth. 

Here we present some of the past winners, 
along with highlights from the entrants for 
Mission Space Lab 2021. 


2019/2020 Mission Space Lab 


Pardubice Pi 
SPSE a VOS Pardubice, Czech Republic 


Using NDVI (Normalised Difference Vegetation 
Index) analysis on photos of vegetation, the 
team was able to analyse loss of vegetation 
compared to historic images of the same 
1KeXer<h Ce) ekspum 40) 0 mer. bole x=r-(6mr- 10/001 mr-00 mad etme ebe lod RS 
here: magpi.cc/msl2020. 
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235 2 experiments 
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meen’ 
T 5 9 5 fey-lauioll ey-)ales 2 5 countries 
(28.8%) ya — 7 49 teams 


a\irelle)(smaem ala 
female participants 





48 
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Astro Pi Mission Space Lab 
yl ovley MAO VA Malle lalive lass 


T he winning teams of the latest Astro Pi ee This team KS looking it) 


mission have not been announced at 


the time of writing, but here are some study Wats evolution of 


amazing highlights. Look forward to next issue 


to read about the winning teams! vegetation PT ROLUEELE Wits world ” 





Team HamCloud Team Blue-3A 





This English team captured lightning inthe clouds _ Italian team Blue-3A captured Turks and Caicos. 
during a night-time storm over South America — The blue filter really accentuates the blueness of 
the first time this has ever happened during Astro _ the barrier reef. Images are being taken to analyse 
Pi. Their experiment is to test cloud density to see how vegetation and inland waters (rivers, lakes, 

if it’s been affected by climate change. etc.) influence local climates. 











Team Imposter Team BetVeg 

A team from Ireland, they captured a great photo Team BetVeg from Spain got this amazing photo 

of the Maldives. Their experiment hopes tobe able _ of the southern part of Great Britain. This team is 
to compare historial data for regions that have looking to study the evolution of vegetation around 
had wildfires, to help predict what areas maybein the world, comparing images to photos from 
danger of future fires. previous Astro Pi missions. 
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Tech4Good 
y Colello indie) al=\-) a- 





he Tech4Good awards are an annual 
event that celebrate many aspects of 


technology. One accolade is the BT Young 


Pioneers Award, given to young folks that are 
using tech to support climate action and other 
social good projects. Several winners have all 
done so with Raspberry Pi projects, showing 
how versatile Raspberry Pi is. 


Kiera McKillop and 
Sinead McKeown - 2017 
Dyslexic Aid 
magpi.cc/dyslexicaid 


Dyslexia effects a significant portion of the 
population, and results in people having some 
difficulties with reading and writing. The 
Dyslexic Aid creates a multi-sensory learning 
environment that stimulates different senses, 
aimed specifically at helping dyslexic pupils. 
With a very limited budget, they were able to 
do research and build the device with just a 
Raspberry Pi and a Sense HAT, and make use of 
its full suite of functions. 


Mihika Sharma - 2019 
Smart Stick 
magpi.cc/smartstick 


Mihika is also nine years old, and made the 
Smart Stick for blind people after witnessing 
her mother helping a blind person across the 
road. The Smart Stick is surprisingly, well, 
smart. As well as the visible ultrasonic distance 
sensors to detect obstacles, it can detect 
puddles, it has motors that guide the user left 
or right depending on smartphone satnav 
directions, LED lights for night-time, and 
Braille writing to let users know where to place 
a left or right hand. It’s won other awards as 
well, and for good reason. 
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Arnav Sharma - 2016 
AsthmaPi 
magpi.cc/asthmapi 


Arnav is one of the youngest award winners 

in this article at only nine years old. After 
studying the intricacies of the respiratory 
condition asthma, he hooked up a suite of 
sensors to a Raspberry Pi to monitor the 
quality of the air in an asthma sufferer’s home 
and send messages with reminders, alerts, 
and even warnings to their phone. It can also 
help figure out any unknown triggers that can 
result in an asthma attack. 


°° The Smart Stick 
Is surprisingly, 
well, smart 7” 
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Awards from The MagP! 


As well as favourites, there have been winners... 


Issue 50. 
community award 


To celebrate our 50th issue, 
we decided to count down 
50 incredible projects, with 
the top 20 voted for by 

our community. The top 

sa AtCembavel LbCe(=re mba eln=reble) (= 
creations, such as the 
SeeMore cluster computer 
art project and the BrewPi 
beer brewing system that a 
lot of adult makers love. 


Mrclel om ilace)s 
magicmirror.builders 


A classic project. The concept, popularised by Michael 
Teeuw, has exploded in popularity, with people 
creating straight smart mirrors, smart vanity mirrors, 
and even recycling a broken iPad to act as a mirror. It’s 
deceptively easy to make one, and installing useful 
code for it is a doddle. It’s very extendible as well, and 
we’ve seen folk add seasonal extras and voice control. 





Issue 75 | 
community award 


In the two years - ay RASPRERRY PY MAGAZINE 
between issues 50 e 

and 75, we were able | a 
to collate 75 brand a 
new and amazing 

projects to once again 

show off in The MagPi. 

Instead of just voting 

for 20 of them, this 

time we had a top 50, 

as voted for by you. 


PiSwitch 
magpi.cc/piswitch 


The design of the Nintendo Switch is an all-timer, 
and many folks have been inspired by its removable 
controllers. PiSwitch went a step further and had 
them connect to a 3D-printed case that also had 

a big display for a Raspberry Pi running RetroPie, 
with the Joy-Cons connected via Bluetooth and 
completely detachable like its inspiration machine. 


Raspberry Pi awards timeline 


Fae (0) I 0) i 0X60) 0) Com (O) Kom ce znS] BLO) t tava oo PUE-U LG MO)‘ c) RO LomE: Ii Pm Coan Wore 0 as 
it’s won plenty of awards itself. Here are just some of them... 


Software Wake el c=y am k-Xed a) 
IWAN Clecmicle Satisfaction Awards Hero Awards - IM Eeled aXe) ol-VameN tel ge Time’s The 10 
Talakeds-] de) p ie) a4 0 (- a - 70) DY a T-Xo mm (e) =X=3-} Wm od cote [Uleas ice) am lalaced’c-14(e)amrelare, |=Y=¥-j Mt CPee le [-\a-me) 
Year Dort award (Raspberry Pi 2) =Varetar-x-\alate) the 2010s 


Lf EEE EEE EEE lo eee 


yA 0} P2 2012 


2017 yA 0} ) 


Award Winning Makes | magpi.cc | 37 











 MagPi | TUTORIAL 


Build the ultimate 





home server with 
Raspberry P1 





PJ Evans 





PJ is a writer, 
software engineer 
and tinkerer. His 
server has just told 
him it’s time for 
another coffee. 


twitter.com/ 
mrpjevans 


> The rear of the case 
organises all the 
ports neatly and the 
bridge connects the 
M.2 drive to your 
Raspberry Pi 4 





server. Why do you need a home server? 
Well, there’s all kinds of uses: file sharing, 
protecting your network from dodgy advertisers, 
controlling your smart devices; the list goes on. In 
this new series, we’ll build a home server with all 
[ You'll Need the bells and whistles to inspire you to create your 
own ultimate build, with plenty of ideas and tips 
along the way. 


Re aspberry Pi also makes a great home 


» Raspberry Pi 4 


magpi.cc/ 
raspberrypi4 

° nara tty ee Choose the right model 
argononem2 It’s probably no surprise that we’ re using 


a Raspberry Pi 4 with 8GB RAM model for our 
>» 1TBM2 SATA ; ; 
eendive ultimate server. It’s the most powerful Raspberry 
magpi.cc/ Pi. However, you can go for lower memory sizes 
wdbluem2 and get similar performance. If you’re interested 
in using advanced file systems like ZFS for 
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Revolutionise your home network with shared storage, medid serving, 
network management, home automation and more. All in one tiny box! 





protecting your data, you’ll need at least 4GB for 
it to work effectively. Then consider what the 
server will be doing. Serving files doesn’t require 
much effort and is well within the capabilities of 
Raspberry Pi Zero, and we strongly recommend a 
wired network connection. 


Choose a case 

Our Raspberry Pi 4 needs a good home 

if it’s going to be a server. There’s no shortage 

of cases available and if you’re lucky enough 

to have a 3D printer, many more designs are 
available for download. Have a think about storage 
requirements such as additional disks or access to 
USB or GPIO connectors. We’ve chosen the Argon 
One case. Not only is it beautiful, it also features 


Wired Ethernet reduces load 
on your wireless network 


ar - ae 
| ry de i, 
ll Be 


passive cooling (as well as a fan) and support for 
M.2 storage devices. As a Server is intended to be 
running 24/7, make sure your choice of case is well 
ventilated and will be placed where it can ‘breathe’. 


Choose storage 

The standard application for a server is file 
Sharing: the ability for anyone in your household to 
access a library of files. If you’re thinking of a media 
server, consider carefully what type of storage to use 
and how much you need. Movies, especially in high- 
definition formats, eat up a lot of space but don’t 
require fast storage to play back reliably. We’re 
making use of the Argon One’s M.2 interface to add 
1TB of fast SSD-based storage, but you may prefer 
one or more USB SSD drives. Using a microSD card 
is still an option, but slower and less reliable. 


Update your bootloader 

By default, a Raspberry Pi 4 and Raspberry 
Pi 400 will try to boot from the microSD card and 
then from a USB attached drive. So you will not need 
to do any additional tweaks to get the M.2 drive 
working. USB boot is also available on most other 
Raspberry Pi models, including Raspberry Pi 2, 3A, 


The Argon One is an attractive 
FY alo 0) ¢-\oi l(ors\ Morsts{- i 10) a= BS\-1aV,-) 6 


3B, and Compute Modules 3+ and 4. However, you 
will need to update the bootloader on these devices. 
See magpi.cc/bootloader for info and instructions. 


Argon assemble! 

Now we have the computer, case and storage, 
it’s time to put them together. The Argon One 
comes with a comprehensive installation guide. Add 
the expansion board to bring all the connections 
to the rear of the case, then mount in the case as 
instructed, using the supplied thermal pads to 
get a good connection between the board and the 
heatsink. Install your M.2 SSD drive in the lower 
part of the case, then screw the two halves together. 
The M.2 SSD device is connected to Raspberry Pi 4 
using an external USB-to-USB bridge. 


Prepare the operating systems 
Preparing an M.2 SSD device is identical to 
preparing an SD card, but connecting the M.2 device 
may be tricky. Either purchase an inexpensive M.2 
to USB device or start with an existing Raspberry 
Pi build and use Argon One M.2’s USB bridge to 
connect it. Then use Raspberry Pi Imager to ‘burn’ 
a Raspberry Pi OS disk image onto the SSD device so 
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TopTip @& 


USB drives 


If you're going for 
mass storage and 
fancy adding an 
array of drives, 
don't forgeta 
powered USB 
hub to avoid 
undervolting - 
this can damage 
your data 

and hardware. 


oo Ma 
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A The Argon One's 
clever expansion 
board brings all the 
connectors to the 
back and converts the 
HDMI ports to full-size 


TopTip 





Which M.2? 


Be careful when 
selecting your M.2 
SSD. The Argon 
One supports 
SATA devices, 

not newer 

NVMe types. 





it’s ready to boot. As this is a server, we don’t need 
a graphical user interface, so we can keep things 
lightweight. Using Raspberry Pi Imager, select 
Raspberry Pi OS Lite and check out the advanced 
menu (CTRL/CMD+SHIFT+X) to set things like 
hostname and networking before burning the 
image to the card. We are naming our hostname 
‘ultimate’ so it is easy to find on the network. 


07 Networking choices 

Full-time servers are not normally connected 
to your network over wireless LAN. Whilst wireless 
is a great technology for end-users, servers crave 
reliability and the best way of delivering that is a 
wired Ethernet connection. We recommend placing 
your server close to your home broadband router 
(or whichever device handles your network traffic). 
That way, the network is not trying to handle two 
wireless conversations: one between you and the 
router and another between the router and the 
server. Wired will be much faster and reliable. If 
this isn’t an option, don’t worry: it’ll still work, but 
larger files may be slow to transfer. 


Boot time 

Let your server boot for the first time, 
making sure no microSD card is inserted. Even if 
you configured it as headless, it’s worth plugging 
a monitor in so you can check everything is OK. It 
will quickly reboot to resize the file system and then 
start up. We used the Advanced menu in Raspberry 
Pi Imager to set the hostname to ‘ultimate’, so with 
a wired connection we can ping ‘ultimate. local’ 
from another computer to confirm it’s on the 
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A The aluminium case connects to the CPU and memory 
using thermal paste to act as a giant heatsink 


network. If you didn’t do this, set up your hostname 
by running sudo raspi-config from a Terminal. 
You can also set up networking here if you need to. 
Update everything with: 


sudo apt update && sudo apt -y full-upgrade 


Boot from microSD 

There is an argument to be made for still 
using a microSD card as the primary boot device. 
This dedicates your M.2 SSD to data only. In the 
event of an operating system failure, your data 

can still be accessed by removing the SSD drive. 
Likewise, if you need to increase your storage 
capability, you avoid having to rebuild your 
operating system from scratch. If you want to take 
this approach, make sure your bootloader prioritises 
the SD card (you can check in raspi-config > 
Advanced Options > Bootloader Version). You will 
you'll need to partition and format the second USB 
drive with an ext4 file system. 





Fan and power button support 

The Argon One case incorporates not only 
passive cooling but also has a fan for keeping our 
Raspberry Pi 4B nice and cool. It’s not the quietest 
but does support active control. To install this, enter 
the following command in a Terminal: 





curl https://download.argon4@.com/argoni1. 
sh | bash 


This will download the drivers and install them 
automatically. The fan will now adjust its speed 


™ We recommend placing 
your server close to your 
Nome broadband router & 


based on temperature. It will also allow the power 
button to cleanly shut down after being pressed 
for three seconds. To change these settings, run 
argonone-config from the command line. 


Access from other devices 

Let’s go back to networking. Our server’s 
hostname is ‘ultimate’, so using the ZeroConf DNS 
system (aka mDNS), it should be on the network as 
‘ultimate.local’. To test this from another machine, 
run ping ultimate.local from the command line 
and see if you get a response from the server. If 
you get no response, check your network settings 
on Raspberry Pi using sudo raspi-config. If using 
wireless LAN, try a wired connection instead. You 
can also use utilities like Fing (fing.com) to see if 
your server has acquired an IP address. (Note that 
versions of Windows prior to 10 do not natively 
support .local addresses.) 


Create a user 

All Raspberry Pi operating systems start with 
a pre-installed user called ‘pi’. So we can share files 
and manage permissions, it makes sense to create 
our own user accounts. To do this, open a Terminal 
as the ‘pi’ user and run this command: 


sudo adduser <name> 
...where <name> is the username you would like 
(avoid spaces and special characters). It will ask 
you a few optional questions about your full name 


and location. Finally, you can set a password 
(be sensible!). 


To give the user ‘super user’ or ‘sudo’ rights: 
sudo adduser <name> sudo 


To give the new user all the same permissions as the 
“pr user: 


sudo usermod -a -G 
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sudo usermod -a -G adm, dialout, cdrom, 
sudo, audio, video, plugdev, games, users, 
input, netdev, gpio, i2c, spi <name> 


SSD for large 
storage needs 


You should now be able to log in as your new user. 
You can create as many of these as you need. 


Create and exchange SSH keys 

A fast and secure way to log into your new 
server is SSH key exchange. If you anticipate lots 
of logging into your new server with SSH, this is an 
essential step. If you’re using Windows, start by 
installing the free OpenSSH client from Microsoft’s 
instructions (magpi.cc/msopenssh). 

From acommanad line, first generate your keypair 

(if you don’t already have one): 


ssh-keygen 


This stores a public and private key in your home 
directory under ~/.ssh. 
Copy your public key over to your server: 


ssh-copy-id <name>@ultimate.local 


... where <name> is the username you created 
previously. Now you can log into your server 
without a password using SSH: 


ssh <name>@ultimate. local 


If your local username matches the server’s, you 
don’t even need to include it or the ‘@’. 


Next time 

You’ve now got the basis for building a powerful 
home server. Next month we’ll move on to the most 
useful aspect of any home server: file sharing. {/ 
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A The lower part of the 
case accepts an M.2 
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2 BUTTON A/ EAST 
> BUTTON B / SOUTH 
> BUTTON X / NORTH 
> BUTTON Y / WEST 
LEFT SHOULDER 
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K.G, 
Orphanides 


K.G. is a writer, maker 
of odd games, and 
software preservation 
enthusiast. Their 
household can 

now hold very retro 
Street Fighter II 
tournaments, and 
that's beautiful 


@KGOrphanides 


More button 
assignments are 
available on RetroPie 
than you have arcade 
controls. You can skip 
the ones that don't 
match up 


CONFIGURING 


Buld an arcade machine: 
RetroPie and stream 


from Steam 


Use RetroPie ds your arcade operating system and add extra emulators with 
Support for Steam Link. Stream games from a powerful PC to Rasbperry PI 


ast month, we used Recalbox for our 
main arcade cabinet operating system, 


but it’s not your only choice. In this final 


instalment of the ‘Build an arcade machine’ 
series, we’ ll use the RetroPie distribution, 
currently at version 4.7, to provide extra 
features such as Steam Link support, as well 
as taking a longer look at where to buy arcade 
games and how to get them onto your system. 
This tutorial assumes that you already have a 
fully assembled and wired arcade cabinet. 


Install and prepare RetroPie 

Fire up Raspberry Pi Imager, connect your 
microSD card writer, and install RetroPie from its 
Choose OS menu. Re-mount the microSD card 
once you’ve finished flashing it, because we’ve 
got some changes to make. 


GAMEPAD 36 
HOLD ANY BUTTON TO SKIP 


OK] 


42 | magpicc | Build an arcade machine: RetroPie and stream from Steam 








As with our DB9 joystick project in issue 101 
(magpi.cc/101), we have to tell the GPIO to treat 
the controls as pull-up switches. Recalbox, by 
comparison, implements this by default. 

Create the pullup.sh file we’ve supplied 

(magpi.cc/pullupfix). You can put it anywhere you 
like — we stuck ours in /home/pi/. Now open /etc/ 
rc.local on the SD card and, above the exit line, add: 


/home/pi/pullup.sh 


This will load your pull-up settings on boot. If you’re 
setting up your disk on a Linux system, you can set 
pullup.sh as executable now. Otherwise, we’ll do that 
on first boot. 


First boot 

Make sure you have a Keyboard plugged 
into your cabinet for this bit. We left ours 
propped up against the marquee acrylic during 
setup for easy access. A Bluetooth keyboard is a 
viable alternative, but it’s easier to start with a 
wired connection. 

Plug in Raspberry Pi’s power. It should boot to the 
EmulationStation interface, but we can’t configure 
the controls until we’ve set our pull-up script 
executable. Press F4 to exit to the command line 
and type: 


chmod /home/pi/pullup.sh +x 
While we’re here, let’s enable SSH: 
sudo raspi-config 


1 system option 
S3 password 
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DOWNLOAD 
THE FULL CODE: 


yy) magpi.cc/rpipullupfix 





enter a new password 
3 interface options 
enable ssh 

yes 


cents Fig ~ 


Ps Bore 


You can now SSH into Raspberry Pi from another 
PC using a client such as Remmina or PulTTY. 


Add hotkey button support 
If, like ours, your arcade cabinet’s GPIO 
controller setup has either one or two extra hotkey 
buttons for easy access to save, load, and exit 
shortcuts while playing, then the standard version 
of the mk_arcade_joystick_rpi driver available from 
RetroPie’s package manager won’t support them. 
We’ll have to manually add an updated version from 
Raspberry Pi is powerful — maintainer Recalbox’s GitLab repo. 
rT atolutelam com aulamaaley-|mer-laai=iy le ‘a, “a : . _— | At the command line, type: 
and you can stream classic and | _ : 
modern arcade titles from a git clone --branch v@.1.9 https://gitlab. 
separate PC on your network er ares +s ore en . com/recalbox/mk_arcade_joystick_rpi.git 
via Steam Link ™ sudo mkdir /usr/src/mk_arcade_joystick_rpi- 
Q0.1.9/ 
cd mk_arcade_joystick_rpi/ 
| sudo cp -a * /usr/src/mk_arcade_joystick_ 
Steam Link lets you create rpi-@.1.9/ 
We (=Xe|(er=1k-10 Mexe)al ge) m gata) op nano /usr/src/mk_arcade_joystick_rpi-0.1.9/ 
C=laal=lanlel=ya kom aateleMvcolelmalelic-\y dkms.conf 
lo]Uinve)am con |amelel(e(-molblacels 
In this file, change PACKAGE_VERSION="$MKVERSION"™ 
to PACKAGE_VERSION="@.1.9". Press CTRL+X to exit, 
then Y to save. 
Back at the command line, enter: 


sudo dkms build -m mk_arcade_joystick_rpi 
WP tale tle, 

sudo dkms install -m mk_arcade_joystick_rpi 
AW) tales, 


reboot 


™ We'll use the RetroPie 
distribution to provide extra 
features such as Steam 
Link Support © 
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A Button and joystick 
correspondences 
for player controls; 
we recommend this 
configuration for use 
with RetroPie. Land R 
map to the right and 
left shoulder buttons 


Optional: Load your hotkey driver 
When Raspberry Pi has rebooted, SSH back 
in and type: 


sudo modprobe mk_arcade joystick_rpi map=1,2 


Go over to the arcade machine and press F4 to get 
to the command line and test your controllers: 


jstest /dev/input/js@ 
jstest /dev/input/js1 


If that works, it’s time to load that module on 
boot. At the command line: 


sudo nano /etc/modules 


In this file, add the following on a new line, then 
save and exit. 


mk_arcade_joystick_rpi 
Next, at the command line: 


sudo nano /etc/modprobe.d/mk_arcade _ 
joystick. conf 


In this file, add the following: 
options mk_arcade_joystick_rpi map=1, 2 


Now Save, exit and reboot. 


Configure RetroPie 
There’s a bit more configuration to do 
before RetroPie is ready to go. SSH in and type: 
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sudo ~/RetroPie-Setup/retropie_setup.sh 


...to open the ncurses configuration menu. 

If you did not manually install a hotkey version 
of the mk_arcade_joystick driver in the previous 
steps and do not need one, go to: 


P manage packages 
driver 
819 mkarcadejoystick 


...and install it. 
If you need to connect any Bluetooth keyboards 
or controllers, go to: 


C Configuration / tools 
804 bluetooth 


Press R to register a device and follow the 
pairing instructions. 

832 samba in the configuration menu sets up 
Samba shares so you can easily transfer ROMs and 
BIOS images over your local network 

You can add extra emulators here, but we’ll 
come to that later. For now, select the R Perform 
reboot option from the main menu. 


Input configuration 

When RetroPie reboots, it should inform 
you that it can detect two GPIO controllers. Press 
and hold any button on the left-hand button 
bank to configure controls for player 1. Because 
arcade controls don’t map perfectly to a gamepad, 
you’ ll have to skip some buttons by pressing and 
holding any key. 


™ When RetroPie reboots, It 
Should inform you that it can 
detect two GPIO controllers @ 


Map up, down, left, and right on the arcade 
stick to the D-pad. Follow our button assignment 
diagram to map the top row to button Y, X, and 
L(eft shoulder), and the button below to buttons 
B, A, R(ight shoulder). 

Map Start to player 1’s left-hand front function 
button and Select to their right-hand front 
function button — this will be their ‘insert coin’ 
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< Controller Settings 


Select a controller 


GPIO Controller 1 GPIO Controller 2 





Pair Controller 


button. In our wiring configuration, our single 
hotkey button — the last we set — is associated 
with player 1. 

Approve your configuration, then set up 
player 2’s controls in the same way. 


07 Getting to know RetroPie 
With your controllers configured, RetroPie’s 
main interface will open. Press A to select menus 
and items and B to go back. Press Start to open the 
main menu and Select to open the options menu. 
Press the same button again to close each of these. 

As you have yet to put any games on the system, 
only the RetroPie menu will be available. Here, 
you’ ll find easy access links to configuration 
tools, including some we used earlier. Install 
new emulators and drivers from the RetroPie 
Setup menu. 

You’ ll probably need to disable overscan to get 
rid of a black border around the screen. In the 
ReotroPie menu, select Raspi-config > Display 
options > Underscan > No and then reboot to solve 
the problem. Note that button B is mapped to the 
ENTER key in this set of menus. 

When you add any new games, ROMs or 
emulators, you’ ll have to restart EmulationStation 
by pressing Select, going to Quit, and then 
Restart EmulationStation. 


Install more emulators 

Although this is an arcade machine, 
you can play what you like on it. The core 
Ir-mame2003 and Ir-fbneo emulators are 
included, along with those for popular consoles 


<4 You'll probably want 
to reconfigure your 
controls in Steam 
Link to better match 
its Steam Controller- 
based expectations 


Setup Controller 


such as the Sega Mega Drive, used in some : 
arcade systems and for which original games are Top TI p ey 
legally available. 

Some emulators require system BIOS images. Steam Link 
Sadly, very few of these have been made smoothly 
legally available to emulation enthusiasts. SNK . 
distributes a UniBIOS compatible BIOS set in its en 


40th Anniversary Collection. We recommend 
adding the following: 


connection for 
optimal Steam 
Link game 

opt > 327 opentyrian — arcade-like DOS shoot- streaming. 


*em-up Tyrian 2.1 is now freeware. 





exp > 241 lr-mame — a more up-to-date 
version of MAME that supports a wider range of 
ROMs. Install from source for bleeding edge. 


exp > 307 digger — a sanctioned remaster of 
Windmill Software’s Dig-Dug. 


exp > 334 steamlink — this allows you to stream 
less emulation-friendly titles directly from a 
Steam installation on a Windows or Linux PC. 


Configure your emulator 

Once you’ve installed a new emulator, such 
as Ir-mame, you’ll have to configure the libretro 
back end to use it by default for either all games 
or selected titles. The easiest way to do this is 
to browse to the game you want to play in the 
EmulationStation front end. 

Go to the Arcade menu, press B to Start any 
game — it doesn’t matter if it currently works or 
not — and then press B again when you’re briefly 
prompted to ‘press a button to configure’. Select 
option 1 to set the default emulator for arcade 
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P  RetroPie is 
significantly more 
configurable than 
Recalbox, although its 
interface doesn't look 
quite as slick 





A screw loose 


If the ball on your 
joystick is loose, 
use a screwdriver 
in the slot on the 
underside of the 
stick or cloth- 
wrapped pliers to 
hold the shaft still 
while you tighten 
the ball. 
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games and choose Ir-mame. Option 2 allows you 
to select a different emulator for anything that 
doesn’t work well with this. 


Connect Steam Link 

Linking Steam to your arcade cabinet lets 
you stream a wealth of modern and classic arcade 
games to Raspberry Pi from a more powerful PC, 
like Melty Blood, Guilty Gear, Horizon Chase Turbo, 
and Street Fighter V. After you’ve installed it and 
restarted EmulationStation, go to the Ports menu 
and select Steam Link. 

It’11 download updates — you will need a keyboard 
plugged in to approve these — and then run. 

Make sure Steam is running on a PC on your local 
network and that Enable Remote Play is ticked 
under Settings > Remote Play. 

On the arcade machine, select the computer you 
want to link to. Steam Link will show a code. Enter 
this in your PC’s Steam client when prompted. To 
avoid a resolution mismatch, run Steam witha 
monitor that matches the resolution of your arcade 
machine set as your primary display. 


Configure Steam Link 

You may want to reconfigure your controls, 
as Steam Link doesn’t inherit the control layout 
from RetroPie’s EmulationStation, and some 
games do better with alternative button 
assignments — for example, to more closely match 
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Launches the RetroArch GUI so you can change 
RetroArch options. Note: Changes will not be saved 
unless you have enabled the "Save Configuration On 
Exit" option. 





an Xbox or Steam Controller, which swaps the 
position of the B and A buttons. 

To set these, launch Steam Link, press up to 
highlight the gear icon, press A (per our button 
assignment diagram), go right to highlight 
Controller and press A. Select the controller you 
wish to configure, then press down and right 
twice, and select Setup Controller. 

Hit the button you want to associate with each 
Steam Controller-style button as it’s displayed 
on screen. Use a keyboard or your second set of 
controls to use the skip button at the bottom to 
bypass extraneous buttons. 


Why use Steam Link? 

Steam Link is an invaluable tool for arcade 
emulation enthusiasts, not only because you can 
play more CPU-intensive games, but also because 
it’s the best way of ensuring copyright compliance 
for anumber of re-released arcade games. 

We’ ve been playing Ghouls ’N Ghosts from the 
Capcom Arcade Stadium on our cabinet via Steam 
Link. Unlike some SNK and Sega re-releases, 
Capcom doesn’t supply emulator-ready ROM files 
and the EULA for that compilation doesn’t allow 
you to extract its PAK files. 

Neil Brown of decoded.legal opines (magpi.cc/ 
romextractionlegal) that “when even a legitimate 
Steam purchaser extracts the ROMs and runs them 
on their own Raspberry Pi, they infringe Capcom’s 
copyright”, making streaming these titles your 
best option for fully legal home arcade action. J] 
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PROFESSIONAL CONTROL SYSTEM DEVELOPMENT TOOL 


Home projects made easy. 


CDP Studio, a great software development tool for your home projects. Build 
systems for Raspberry Pi, use C++ or NoCode programming, open source libraries, 
out of the box support for GPIO, I2C, MQTT, OPC UA and more. Create beautiful user 
interfaces. Built for industrial control system development, FREE for home projects. 


cdpstudio.com 
N=) beer Vaecho] Oo 10 eo] 010 abel @ilere | elx-lelnmere)an ; 
CDP Technologies AS // Hundsvzergata 8, 6008 Alesund, Norway CDF Studio 
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Create GUIs with Python: 
Emoyj1 Match 


Create ag fun picture-matching game 


ou are going to build an emoji picture- 
Y matching game (Figure 1). The object of 

the game is to spot the one emoji that 
appears in two different sets. You get a point 


for each correct match and lose a point for an 
incorrect match. 


Loading emojis 

To create the game, you will need some emojis. 

You can use the emojis created for Twitter 
(twemoji.twitter.com). Download the emojis.zip 
file from magpi.cc/guizeroemojis, open the zip file, 
and copy the emojis folder to the folder where you 
Save your code. 

The game will need to choose nine emojis at 
random and arrange them into a grid. A simple way 
to do this is to put all of the emojis into a list and 
randomly shuffle them. 

Create a new program with the usual commented 
lines for different sections (Imports, Variables, 
Functions, App), as we’ve done in previous 
instalments. Under imports, add: 


Figurel _ 





A Figure 1 The finished game 
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import os 
from random import shuffle 


Then, under variables, enter this code which 
creates a shuffled list of emojis, each in the form 
path/emoji_file_name. 


# set the path to the emoji folder on your 
computer 

emojis_dir = "“emojis" 

emojis = [os.path.join(emojis dir, f) for f 
in os.listdir(emojis dir) ] 

shuffle(emojis ) 


The emojis_dir variable is the path of the emojis 
on your computer; it will tell the code that loads 
the emojis where to find them. 

Test your program. Try printing the emojis list 
to the screen with print(emojis). You should see 
a long list of file names. The list should be ina 
different order each time you run it. 


Displaying the emojis 
Next, the code needs to create two 3x3 grids of 
Picture and PushButton widgets which will show 
the emojis. 

Modify your program to create a guizero app and 
a Box to hold the picture widgets using a "grid" 
layout. In the imports section, add this line to 
import the required widgets: 


from guizero import App, Box 
In the app section, add the following code: 

app = App("emoji match") 

pictures box = Box(app, layout="grid" ) 
The Box widget is really useful for laying out your 


GUI. It’s an invisible area of your GUI where you 
can group widgets together. A Box can have its own 


layout, size, and bg (background). They can also be 
hidden or shown, meaning you can easily make a 
collection of widgets invisible. 

If you wish to see the Box, you can add a border 
by setting the parameter to True. 


pictures box = Box(app, layout="grid", 
border=True) 


Now, add the Picture widget to your imports: 
from guizero import App, Box, Picture 


In the app section, add in the code to create the 
Picture widgets and add them to a list. 


pictures = [ | 


for x in range(@,3): 
for y in range(@, 3): 
picture = Picture(pictures_box, 
grid=[x,y]) 
pictures.append(picture) 


To assign co-ordinates to each Picture widget, 
two for loops are used. They both run through the 
range O-2; one assigns its value to the variable x 
and the other to the variable y. The grid position 
of each widget is set using the x and y values. 
The widgets are appended to a list so they can be 
referenced later in the game. 

Do the same for PushButton widgets to create 
the second 3x3 grid. First, add the widget to 
your imports: 


from guizero import App, Box, Picture, 
PushButton 


In the app section, add lines so it looks like this: 
app = App("emoji match") 


pictures box = Box(app, layout="grid") 
buttons box = Box(app, layout="grid") 


pictures = [ ] 
buttons = [] 


for x in range(@,3): 
for y in range(@, 3): 
picture = Picture(pictures_box, 
grid=[x,y]) 
pictures.append(picture) 
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™ The widgets are appended to ga list so they 
con be referenced later in the game 4 


emoji1.py 


» Language: Python 3 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 


016. 
017. 
018. 
019. 
020. 
Q21. 
Q22. 
Q23. 
024. 
Q25. 
026. 
027. 
028. 
Q29. 
030. 
Q31. 
Q32. 
033. 
034. 
Q35. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
050. 
Q51. 


import os 
from random import shuffle 


THE FULL CODE: 


vy) magpi.cc/guizerocode 


DOWNLOAD 









from guizero import App, Box, Picture, PushButton 


# set the path to the emoji folder on your computer 


emojis_dir = "“emojis" 


emojis = [os.path.join(emojis dir, f) for f in os.listdir( 


emojis_ dir) | 
shutfle(emojis ) 


def setup _round(): 
for picture in pictures: 


picture.image = emojis.pop() 


for button in buttons: 


button.image = emojis.pop() 


app = App("emoji match") 


pictures_box = Box(app, layout="grid") 
buttons_box = Box(app, layout="grid") 


pictures = [] 
buttons = [ ] 


for x in range(@,3): 
for y in range(@,3): 


picture = Picture(pictures_box, grid=[x,y]) 


pictures.append(picture) 


button = PushButton(buttons_box, grid=[x,y]) 


buttons. append(button) 


setup_round() 


app.display() 
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emoji2.py 


» Language: Python 3 


0e1. 
0@2. 
003. 
004. 
005. 
006. 
007. 
008. 
0e9. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
Q21. 
O22. 
Q23. 
024. 
@25. 
026. 
027. 
028. 
Q29. 
030. 
031. 
O32: 
Q33. 
034. 
Q35. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
Q50. 
Q51. 
052. 
O53. 
054. 
@55. 
Q56. 
057. 
Q58. 
959. 


import os 
from random import shuffle, randint 
from guizero import App, Box, Picture, PushButton 


# set the path to the emoji folder on your computer 
emojis_ dir = "“emojis" 


emojis = [os.path.join(emojis dir, f) for f in os.listdir(emojis dir) ] 


shutfle(emojis) 


def setup_round(): 
for picture in pictures: 
picture.image = emojis.pop() 


for button in buttons: 
button.image = emojis.pop() 


matched_emoji = emojis.pop() 


random_picture = randint(@,8) 
pictures[random_picture].image = matched_emoji 


random_button = randint(@,8) 
buttons[random_button].image = matched_emoji 


app = App("emoji match") 


pictures box = Box(app, layout="grid") 
buttons box = Box(app, layout="grid") 


pictures = [] 
buttons = [] 


for x in range(@,3): 
for y in range(@,3): 
picture = Picture(pictures_box, grid=[x,y]) 


pictures. append(picture) 


button = PushButton(buttons_box, grid=[x,y]) 
buttons. append(button) 


setup _round() 


app.display() 
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oa me 


A Figure 2 No matching emojis 


button = PushButton(buttons_box, 


grid=[x,y]) 
buttons.append(button) 


In the functions section, create a function to set up 
each round of the game. 


def setup _round(): 
for picture in pictures: 
picture.image = emojis.pop() 


for button in buttons: 
button.image = emojis.pop() 


To assign each picture and button widget an emoji, 
the image property is set to an item from the emojis 
list. Emojis are selected using pop(), which chooses 
the last item in a list and then removes it from the 
list. We’ve used this function because it will prevent 
any emoji appearing in the game more than once. 
At the bottom of your program, call the 
setup_round function and display the app. 


setup_round() 


app.display() 


Your program should now resemble emoji1.py (see 
previous page). Test it and you should see two grids 
of nine emojis. 


Matching emojis 

At the moment, all of the emojis in your app will 
be different (Figure 2). In the next step, you will 
pick another emoji to match, and update one 
picture and one button so they have the same 
matching emoji. 


emMoji3.py 


» Language: Python 3 
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Q01. # ------------- nner eee nee eee 38. buttons[random_button].image = matched_emoji 
002. # Imports @39. 
Q03. # ------------------------------ e042. buttons[random_button].update command( 
04. match_emoji, [True]) 
@05. import os 041. 
@06. from random import shuffle, randint Q@42. def match_emoji(matched): 
Q@07. from guizero import App, Box, Picture, PushButton, 043. if matched: 
008. Text 044. result.value = "correct" 
09. Q45. else: 
O10. # wn n-ne nn rn nen rrr nee n ene 046. result.value = "incorrect" 
011. # Variables 047. 
Q@12. # ------------------------------ 048. setup_round() 
Q13. Q49. 
014. # set the path to the emoji folder on your computer Q50. # ------------------------------ 
Q@15. emojis_ dir = “emojis" Q51. # App 
Q@16. emojis = [os.path.join(emojis dir, f) for f in Q52. # ------------------------------ 
Q@17. os.listdir(emojis dir) ] 053. 
Q@18. shutfle(emojis) Q@54. app = App("emoji match") 
019. 655. 
Q@20. # ------------------------------ @56.  pictures_box = Box(app, layout="grid") 
@21. # Functions @57. buttons_box = Box(app, layout="grid") 
O22,. Ff See Ree e SER ee Ree elem meme 058. 
Q23. Q@59. pictures = [] 
@24. def setup _round(): @60. buttons = [] 
@25. for picture in pictures: 061. 
Q26. picture.image = emojis.pop() @62. for x in range(@,3): 
Q27. 063. for y in range(@,3): 
Q28. for button in buttons: 064. picture = Picture(pictures_ box, grid=[x,y]) 
Q@29. button.image = emojis.pop() 65. pictures.append(picture) 
030. button.update_command( 066. 
match_emoji, args=[False]) Q67. button = PushButton(buttons_box, grid=[x,y]) 
Q@31. 068. buttons. append(button) 
Q32. matched_emoji = emojis.pop() Q69. 
Q33. @70. result = Text(app) 
Q34. random_picture = randint(@,8) Q71. 
@35. pictures[random_picture].image = matched_emoji @72. setup_round() 
Q36. Q73. 
37. random_button = randint(@,8) Q@74. app.display() 


Add randint to your random import line. This 
is used to obtain a number from O to 8 for each 
picture and button. 


from random import shuffle, randint 


Then add this code (indented) to the bottom of 

the setup_round function to pop another emoji 
from the list and set it to be the image of a random 
picture and button. 


matched _emoji = emojis.pop() 


random_picture = randint(@, 8) 
pictures[random_picture].image = matched _ 
emoji 


random_button = randint(@,8) 
buttons[random_button]|.image = matched_ 
emoji 


Your code should now look like emoji2.py. Run 
your program now; one of the emojis should 
match. Look carefully - the matching emoji can be 
hard to spot. 


Check the guess 
Each time one of the PushButtons is pressed, it will 
need to check if this is the matching emoji and put 
the result ‘correct’ or ‘incorrect’ on the screen. 
After the player’s guess, a new round will be set up 
and different set of emojis displayed. 

Your app will need a Text widget display the 
result. Add it to your imports: 


from guizero import App, Box, Picture, 
PushButton, Text 


Add this line in your app section: 


result = Text(app) 
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emoji4.py 


» Language: Python 3 


OGly GW See psS oes s— See ese Sees e046. result.value = “incorrect” 
Q@0@2. # Imports Q47. score.value = int(score.value) - 1 
@@3. # ------------------------------ e048. 
e004. e49. setup_round() 
@05. import os Q5e. 
@06. from random import shuffle, randint Q@51. def reduce _time(): 
Q@07. from guizero import App, Box, Picture, PushButton, Text Q52. timer.value = int(timer.value) - 1 
008. 053. # is it game over? 
O09, gf SSStSeSeos Saat eee eae Sess Q@54. if int(timer.value) < @: 
010. # Variables @55. result.value = "Game over! Score = “ + score.value 
Olly @ SsseSsse-o Sess snshes4555-4=- 056. # hide the game 
Q@12. Q@57. pictures _box.hide() 
013. # set the path to the emoji folder on your computer 058. buttons_box.hide() 
014. emojis dir = “emojis" @59. timer .hide() 
Q@15.  emojis = [os.path.join(emojis dir, *) for f in 062. score.hide() 
Q16. os.listdir(emojis dir) ] 061. 
Q@17.  shutfle(emojis) Q62. # ------------------------------ 
018. 063. # App 
Q@19. # ------------------------------ Q64. # ------------------------------ 
@2@. # Functions 065. 
O21, enn nnn nr ern rr nee nner nrc ene @66. app = App("emoji match") 
Q@22. Q67. 
@23. def setup round(): @68. score = Text(app, text="0") 
Q@24. for picture in pictures: @69. timer = Text(app, text="30") 
e25. picture.image = emojis.pop() 70. 
Q26. @71. pictures_box = Box(app, layout="grid") 
O27. for button in buttons: @72. buttons_box = Box(app, layout="grid") 
28. button.image = emojis.pop() 073. 
Q29. button.update_command(match_emoji, args=[False]) @74. pictures = [] 
030. @75. buttons = [] 
Q@31. matched_emoji = emojis.pop() 76. 
Q@32. @77. for x in range(@,3): 
Q33. random_picture = randint(@,8) Q78. for y in range(@,3): 
34. pictures[random_picture].image = matched_emoji Q79. picture = Picture(pictures_box, grid=[x,y]) 
@35. 080. pictures.append(picture) 
036. random_button = randint(@,8) 081. 
37. buttons[random_button].image = matched_emoji Q82. button = PushButton(buttons_box, grid=[x,y]) 
038. 083. buttons. append (button) 
Q39. buttons[random_button].update_command( 084. 
match_emoji, [True]) @85. result = Text(app) 
42. 086. 
Q@41. def match_emoji(matched) : @87. setup _round() 
Q42. if matched: 088. 
043. result.value = "correct" @89. app.repeat(1000, reduce time) 
e044. score.value = int(score.value) + 1 e9e. 
Q@45. else: Q@91. app.display() 


Create a new function which will be called when 
one of the emoji buttons is pressed. It will display 
‘correct’ or ‘incorrect’ and call setup_round to 


Create Graphical User 
Interfaces with Python 


Graphical User 


For further tutorials on how interfaces with Python create the next set of emojis. 

to make your own GUIs with — 

guizero, take a look at our ; — def match_emoji(matched): 

book, Create Graphical User } o ve if matched: 

Interfaces with Python. lts eon avalucre sconrece: 

156 pages are packed with Stee: 

essential info and a range of ; 3 
result.value = "incorrect" 


exciting projects. 
magpi.cc/pythongui 





setup _round() 
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Using other images 


The emoji match game uses picture buttons to allow 
the user to pick which emoji matches. You can make 
any PushButton widget into a picture button by 
setting the image parameter; for example: 


button = PushButton(app, image="my_picture.gif" ) 


The button will scale to fit the size of your image. 
The type of image you can use is determined 

by your operating system and how you installed 
guizero, although any setup will support GIF images. 
To find the image file types supported by your 
setup, you can run: 


from guizero import system_config 
print(system_config.supported_image_types) 


You can find out more about image support in 
guizero at lawsie.github.io/guizero/images. 





The incorrect emoji buttons will pass False to the 
match_emoji function; the matching emoji will 
pass True. 

Update the setup_round function so that all the 
‘incorrect’ buttons call the match_emoji function. 


for button in buttons: 
button.image = emojis.pop() 
button.update_command(match_emoji, 
args=[False]) 


The update_command method sets the function 
which will be called when the button is pressed. 
The args list [False] will be used as the parameters 
to the match_emoji function. 

Finally, update the command for the matching 
button so it calls match_emoji, but this time passes 
True as the argument. 


buttons[random_button].update__ 
command(match_emoji, [True]) 


Your code should now resemble emoji3.py 
(previous page). Play the game. In each round there 
will be a matching emoji — press the matching 
picture button. Did you get it right? 


Adding a score and timer 
At the moment, the game continues forever (or 
until you run out of emojis in the list). Add a score 
and a timer which counts down to the end of the 
game to give achallenge. 

In the app section, create two Text widgets to 
show the score and the timer. 








Qs 4 


Text(app, text="0") 
Text(app, text="30") 





ll 


score 
timer 


The timer is set to "30", which will be the number 
of seconds in each round. 

Modify the match_emoji function to either add or 
subtract 1 to/from the player’s score. 


def match_emoji(matched) : 
if matched: 
result.value = "correct" 
score.value = int(score.value) + 1 
else: 
result.value = "incorrect" 
score.value = int(score.value) - 1 


To create the timer, you will use a feature of 
euizero which allows you to ask the application to 
continuously call a function every 1 second. 

Create a function which will reduce the value of 
the timer by 1. 


def reduce _time(): 
timer.value = int(timer.value) - 1 


Before the app is displayed, use the app. repeat () 
function to call the reduce_time function every 
second (1000 milliseconds). 


app.repeat(1000, reduce time) 


app.display() 


Running your game now, you will notice that the 
timer counts down from 30. Unfortunately, it will 
continue counting down past 0 and never stop. 
Update the reduce_time function to check if the 
timer is less than zero and then stop the game. 
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< Figure 3 With box 
for score and timer 
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09-emoji-match.py 


» Language: Python 3 


| 9 5 Q@47. score.value = int(score.value) - 1 
002. # Imports 048. 
003. nnn nnn nnn nr nen n ene nn ee-- 49. setup_round() 
004. 050. 
@05. import os Q@51. def reduce time(): 
@06. from random import shuffle, randint Q52. timer.value = int(timer.value) - 1 
Q@07. from guizero import App, Box, Picture, PushButton, Text 053. # is it game over? 
208. @54. if int(timer.value) < 2@: 
OOO, a mses Se ate See eee @55. result.value = "Game over! Score = " + score.value 
010. # Variables 056. # hide the game 
Olly dpssaneessneceee Sesssersesess-= Q@57. game_box.hide() 
Q12. 058. 
Q@13. # set the path to the emoji folder on your computer Q59. # ------------------------------ 
Q14. emojis dir = “emojis" Q60. # App 
Q@15. emojis = [os.path.join(emojis dir, f) for f in Q61. # ------------------------------ 
Q@16. os.listdir(emojis dir) ] 062. 
Q@17.  shutffle(emojis) @63. app = App("emoji match") 
018. 064. 
O19, nnn nn renner nen enn e eee @65. game_box = Box(app, align="top") 
Q@2@. # Functions 066. 
Q@21. # ------------------------------ @67. top _box = Box(game_box, align="top", width="fill") 
Q@22. @68. Text(top_box, align="left", text="Score ") 
@23. def setup_round(): @69. score = Text(top_box, text="4", align="left") 
Q@24. for picture in pictures: @70. timer = Text(top_box, text="30", align="right") 
@25. picture.image = emojis.pop() Q@71.  Text(top_box, text="Time", align="right") 
026. 072. 
Q27. for button in buttons: @73.  pictures_box = Box(game_box, layout="grid") 
Q28. button.image = emojis.pop() @74. buttons _box = Box(game_box, layout="grid") 
Q29. button.update_command(match_emoji, args=[False]) Q75. 
030. @76. pictures = [] 
Q@31. matched_emoji = emojis.pop() @77. buttons = [] 
@32. 078. 
Q33. random_picture = randint(@,8) @79. for x in range(@,3): 
Q@34. pictures[random_picture].image = matched_emoji 80. for y in range(@,3): 
Q@35. 81. picture = Picture(pictures_box, grid=[x,y]) 
Q@36. random_button = randint(@,8) Q82. pictures. append(picture) 
037. buttons[random_button].image = matched_emoji 083. 
38. 084. button = PushButton(buttons_box, grid=[x,y]) 
Q@39. buttons[random_button].update_command( Q85. buttons. append(button) 
match_emoji, [True]) Q86. 
e042. Q@87. result = Text(app) 
Q@41. def match_emoji(matched): 88. 
Q42. if matched: @89. setup_round() 
043. result.value = “correct” 90. 
44. score.value = int(score.value) + 1 Q91. app.repeat(1008@, reduce time) 
Q@45. else: Q@92. 
e046. result.value = “incorrect” Q93. app.display() 
def reduce time(): When the timer is less than 0, the message ‘game 
timer.value = int(timer.value) - 1 over’ is displayed and the game's widgets are 
# is it game over? hidden so the user can no longer play. 
if int(timer.value) < @: See emoji4.py to get an idea of how your code 
result.value = "Game over! Score = should now look. Run it and play the emoji match 
" + score.value game. Challenge a friend or family member to 
# hide the game a game. 
pictures _box.hide() You may want to put the score and timer 
buttons _box.hide() widgets into a Box so they can be laid out better 
timer .hide() (Figure 3, previous page) — see the complete 
score. hide() 09-emoji-match.py listing for how to do this. !] 
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Ben Everard 


wW @ben_everard 





Ben's house is slowly 
being taken over by 3D 
printers. He plans to 
solve this by printing an 
extension, once he gets 
enough printers. 


ames controllers — like keyboards 

— are very personal things. What 

works for one person may not work 

for another. Why, then, should we 

all use almost identical off-the-shelf 

controllers? Let's take a look at how 
to use Raspberry Pi Pico to create a controller that’s 
just right for you. 

We'll use CircuitPython for this as it has excellent 
support for USB interfaces. The sort of USB devices 
that we interact with are called human interface 
devices (HIDs), and there are standard protocols for 
common HIDs, including keyboards and mice. This 
is why, for example, you can plug almost any USB 
keyboard into almost any computer and It will just 
work, with no need to install drivers. 

We'll be using the Keyboard type, as that works 
best with the sorts of games that this author likes to 
play, but you can use exactly the same technique to 
simulate a mouse or a gamepad. 

Before we get onto this, though, let's take a look at 
the buttons and how to wire them up. 

We're going to use eight buttons: four for direction, 
and four as additional ‘action’ buttons. We'll connect 
these between an |/O pin and ground. You can use 
any I/O pin you like. We're going to use slightly 
different ones in two different setups, just because 
they made sense with the physical layout of the 
hardware. Let’s take a look at the hardware we're 
using. Remember, this is just the hardware we want 
to use. The whole idea of this is to create a setup 
that’s right for you, so there's no need to use the 
same. Think about how you want to interact with your 
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“4 


Custom USB games 
controllers with Pico 


Play games the way you want to 


games and take a look at the available input devices 
and build what you want. 

The first setup we're creating is an Arcade box. 
This author would really like an arcade machine In 
his house. However, space limitations mean that this 
isn't going to be possible in the near future. The first 
setup, then, is an attempt to recreate the control 
setup of an arcade machine, but use it to play games 
on a laptop rather than a full-sized cabinet. 

Arcade controls are quite standard, and you can 
get them from a range of sources. We used one 
of Pimoroni’s Arcade Parts sets, which includes a 
joystick and ten buttons (we only used four of these). 
The important thing about the joystick you pick is that 
it's a button-based joystick and not an analogue one 
(sometimes called a dual-axis joystick), as the latter 
won't work with a keyboard interface. If you want 
to use an analogue joystick, you'll need to switch 
the code around to use a mouse or gamepad as an 
input device. 

As well as the electronics, you'll need some way of 
mounting them. We used a wooden craft box. These 
are available for about £10 from a range of online or 
bricks and mortar stores. You can use anything that is 
strong enough to hold the components. 

The second setup we're using is a much simpler 
button-based system on breadboard-compatible 
tactile buttons and protoboard. It’s smaller, cheaper, 
and quicker to put together. The protoboard holds 
everything together, so there’s nothing extra to 
add unless you want to. You can personalise it by 
selecting different-sized buttons, changing the layout, 
or building a larger chassis around this. 





INSERT COIN TO CONTINUE 

Let's take a look at the arcade setup first. The joystick 
has five pins. One is a common ground and the others 
are up, down, left, and right. When you push the 
joystick up, a switch closes, linking ground to the up 
pin. On our joystick the outermost pin is ground, but 
it's worth checking on your joystick which pin is which 
by using a multimeter. Select continuity mode and, if 
you push the joystick up, you should find a continuous 


v7, 


The joystick has five pins. 
One is a common ground 


W 


connection between the up pin and ground. A bit of 
experimentation should confirm which pin is which. 
In order to read the pins, we just need to connect 
the directional output from the joystick to an I/O pin 
on Pico. We can use one of Pico’s internal pull-up 
resistors to pull the pin high when the button isn't 
pressed. Then, when the button Is pressed, it will 
connect to ground and read low. The joystick should 
come with a cable that slots onto the joystick. This 
should have five outputs, and this conveniently slots 
into the I/O outputs of Pico with a ground on one end. 
The buttons, similarly, just need to be connected 
between ground and an |/O pin. These came with 
cables that pushed onto the button and plugged into 


and the others are up, 
down, left, and right 


adjacent pins. Since Pico has eight grounds available, 
there are enough that each button can have its own 
ground, and you don't have to mess around joining 
cables together. 

Once all the cables are soldered together, it’s just a 
case of building the chassis. For this, you need five 
large holes (one for the joystick and four for the 
buttons). We didn't have an appropriately sized drill bit 
and, given how soft the wood on these boxes is, a 
large drill bit may have split the wood anyway. 
Instead, we drilled a 20mm hole and then used a 
rotary tool with sanding attachment to enlarge the 
hole until it was the right size. You have to go quite 
easy with both the drill and the sanding tool to avoid > 


[MAKE Bul 


Hackspace 


TUTORIAL | Magri 


Lo HACK 





HackSpace 


This tutorial is from 
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pin headers straight 
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controller that you can 
fit in your pocket 





Warning! 
Soldering iron 


Be careful when using 
a hot soldering iron 
and read Raspberry 

Pi's Getting started with 
soldering guide. 


magpi.cc/soldering 


turning everything into shards of broken wood. Four 
small holes then allow bolts to keep the joystick in 
place (we used Mb bolts). The buttons just push 
into place. 

The only remaining thing was a 12mm hole for a 
micro USB cable to pass through to Pico. If you don't 
have a 12mm drill bit, two overlapping smaller holes 
may work if you're careful. 

The buttons just push-fit into place, and that’s 
everything ready to go. 


A SMALLER APPROACH 

Our smaller option used protoboard over the back of 
Pico. Since we didn't want to block the BOOTSEL 
button, we only soldered it over part of Pico. 
However, before soldering it on at all, we soldered the 
buttons in place. 

Tactile switches typically have four connections. 
Well, really they have two connections, but each 
connection has two tabs that fit into the protoboard. 
This means that you have to orientate them correctly. 
Again, your multimeter’s continuity function will 
confirm which pins are connected and which 
are switched. 

Protoboard is a PCB that contains lots and lots of 
holes and nothing else. You solder your components 
into the holes and then you have to create 
connections between them. 

We placed the buttons in the protoboard In 
positions we liked before worrying about the 
wiring. First, we looked to connect one side of each 
switch to ground. To minimise the wiring, we did 
this in two groups. We connected one side of each 
of the direction buttons together and then linked 
them to ground. Then we did the same to all the 
action buttons. 

There are two ways of connecting things on 
protoboard. One is to use jumper wire. This works 
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well if the points are more than a couple of holes 
apart. For holes that are next to each other, or very 
close, you can bridge them. On some protoboard 
(which doesn't have a solder mask), you might 
simply be able to drag a blob of solder across with 
your soldering iron so that it joins both holes. On 
protoboard with solder mask, this doesn't work quite 
so well, so you need to add a little strand of wire Ina 
surface-mount position between the two points and 
solder it in. If you've got a pair of tweezers to hold the 
wire In place while you solder it, it will be much easier. 
For longer connections, you'll need to use jumper 
wire. Sometimes you'll be able to poke it through 


a7 


We placed the buttons in 
the protoboard in positions 
we liked before worrying = 


W 


about the wiring 


the protoboard and use the leg to join. Other times 
you'll have to surface-mount it. This all sounds a bit 
complicated, but while it can be a bit fiddly, it’s all 
fairly straightforward once you put solder to iron. 


PROGRAM IT UP 

Now that we've got the hardware ready, let’s code 

it up. You'll first need to load CircuitPython onto 

your Pico. You can download the latest release from 
circuitpython.org. Press the BOOTSEL button as 
you plug Pico into your USB port, and then drag and 
drop the downloaded UF2 file onto the RP2 USB drive 
that should appear. 





000000000 
000000008 
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We'll use Mu to program Pico. If you've not used 
CircuitPython before, it’s probably worth having a 
quick look through the ‘getting started’ guide here: 
hsmag.cc/CircuitPythonGuide. 

The code to run our games controller ts: 


000000 


import board 


DOWNLOAD 
THE FULL CODE: 


10 C~ 


import digitalio 
import gamepad 
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import time 


x ; 


29: 
‘S 


rove 
OO 


import usb_hid 
from adafruit_hid. keyboard import Keyboard 
from adafruit_hid.keycode import Keycode 


kbd = Keyboard(usb_hid. devices) 





keycodes = [Keycode.UP_ARROW, Keycode.DOWN_ARROW, 
Keycode.LEFT_ARROW, Keycode.RIGHT_ARROW, 

Keycode.X, Keycode.Z, Keycode.SPACE, Keycode. 
ENTER] 


you Call get_pressed(), it will return a byte of data 
where each digit corresponds to an I/O pin. So, the 
following number (in binary) means that the first and 
third buttons have been pressed: 00000101. This is 
a little confusing, because this is the opposite order 
to how the I/Os are passed when you initialise the 
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With a combination 

of small sections of 
wire and jumpers, you 
can create whatever 
pattern of wiring you 
like on protoboard 


pad = gamepad.GamePad( 
digitalio.DigitalInOut(board.GP12), 


digitalio.DigitalInOut(board.GP14), 
digitalio.DigitalInOut(board.GP9), 
digitalio.DigitalInOut(board.GP15), 
digitalio.DigitalInOut(board.GP16), 
digitalio.DigitalInOut(board.GP17), 
digitalio.DigitalInOut(board.GP18), 
digitalio.DigitalInOut(board.GP20), 
) 
last_pressed = Q 
while True: 
this_pressed = pad. get_pressed() 
if (this_pressed != last_pressed): 
for i in range(8): 
if (this_pressed & 1<<i) and not 
(last_pressed & 1<<i): 
kbd. press(keycodes[i]) 
if (last_pressed & 1<<i) and not 
(this_pressed & 1<<i): 
kbd. release(keycodes[i]) 
last_pressed = this_pressed 
time.sleep(0.01) 


This uses the HID keyboard object (called kbd) to 
send key press and release events for different key 
codes depending on what buttons are pressed or 
released. We've used the gamepad module that 

is for keeping track of up to eight buttons. When 
you Initialise it, it will automatically add pull-up 
resistors and set the I/O pins to input. Then, it will 
keep track of what buttons are pressed. When 


GamePad object. 

The while loop may look a little unusual as it’s 
not particularly common to use this sort of binary 
comparison in Python code, but in essence, it’s just 
looking at one bit at a time and seeing either: it's now 
pressed but wasn't last time the loop ran (in which 
case, It's anew button press and we should send It to 
the computer), or it isn’t pressed this loop but was the 
previous loop (in which case, It’s newly released so we 
can call the release method). 

The << operator shifts a value by a number of 
bits to the left. So, 1<<2 is 100, and 1<<3 is 1000. 
The & operator is bitwise and so it looks at a binary 
number and does a logical AND on each bit in turn. 
Since the right-hand side of the & is all zeros apart 
from one bit (at a different position depending on the 
value of i), the result will be dependent on whether 
the value of this_pressed or last_pressed |s 1 or O at 
the position i. When you have an if condition that’s 
a number, It’s true if the number is anything other 
than 0. So, (this_pressed & 1<<2) will evaluate to 
true if there's a 1 at position 2 in the binary form of 
this_pressed. In our case, that means if the joystick is 
pushed left. 

You can grab this code from the following link — 
hsmag.cc/USBKeyboard. Obviously, you will need to 
update the GPIO values to the correct ones for your 
setup when you initialise GamePad. 

We've taken a look at two ways to build a gamepad, 
but it’s up to you how you want to design yours. O 
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Turn Raspberry Pi Pico into g temperature data-logging device 
Gnd untether it from the computer to make it fully portable 
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A Figure 1 The size of the 
: data you've written is 
printed to the Shell area 


you’ve been using your Pico connected to a 

Raspberry Pi or other computer via its micro 
USB port. Like all microcontrollers, though, there’s 
no reason your Pico has to be tethered in this way: 
it’s a fully functional self-contained system, with 
processing capabilities, memory, and everything it 
needs to work on its own. 

In this guide you’1l learn how to use the file 
system to create, write to, and read from files, 
allowing you to put your Pico anywhere you like 
and have it record data for later access — turning it 
into what is known as a data logger. For this you’ ll 
only need your Pico and, if you want to use it away 
from your Raspberry Pi, a micro USB charger or 
battery pack; once you have finished the tutorial, 
you can connect additional analogue sensors if 
you want to expand your project. 


T hroughout our Raspberry Pi Pico tutorials, 





Gareth 
Halfacree 





With a passion 

for Open-source 
software and 
hardware, Gareth 
was an early adopter 
of the Raspberry 
Pi platform and 
has written several 
publications on 

its capabilities 
and flexibility. 


The file system 

The file system is where your Pico stores all the 
programs you’ve been writing. It’s equivalent in 
function to the microSD card in your Raspberry 
Pi, or the hard drive or solid-state drive in your 
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laptop or desktop computer: it’s a form of non- 
volatile storage, which means that whatever you 
save there stays in place even when you unplug 
your Pico’s micro USB cable. 

Connect your Pico to your Raspberry Pi and load 
Thonny, if you don’t already have it open. Click 
the Open icon, and click ‘Raspberry Pi Pico’ in the 
pop-up which appears. You’ll see a list of all the 
programs you’ve been writing so far, stored on 
your Pico’s file system. You’re not going to open 
one right now, so click Cancel. 

Click at the bottom of the Shell area to start 
working with your Pico in interactive mode. Type: 


file = open("test.txt", "w") 


This tells MicroPython to open a file called test.txt 
for writing — the "w" part of the instruction. You 
won’t see anything print to the Shell area when 
you press ENTER at the end of the line, because 
although you’ve opened the file, you haven’t done 
anything with it yet. Type: 


file.write("Hello, File!") 


When you press ENTER at the end of this line, 
you’ll see the number 12 appear (Figure 1). That’s 
MicroPython confirming to you that it has written 
12 bytes to the file you opened. Count the number of 
characters in the message you wrote: including the 
letters, comma, space, and exclamation mark, there 
are twelve — each of which takes up a single byte. 
When you’ve written to a file, you need to 
close it — this ensures that the data you’ve told 
MicroPython to write is actually written to the 
file system. If you don’t close the file, the data 
might not have been written yet — a bit like writing 
a letter in LibreOffice Writer or another word 
processor and forgetting to save it. Type: 


file.close() 


Your file is now safely stored on your Pico’s file 
system. Click the Open icon on Thonny’s toolbar, 
click ‘Raspberry Pi Pico’, and scroll through the list 
of files until you find test.txt. Click on it, then click 
OK to open it: you’1l see your message pop up ina 
new Thonny tab. 

You don’t have to use the Open icon to 
read files, though: you can do it directly in 
MicroPython itself. Click back into the bottom of 
the Shell area and type: 


file = open("test.txt") 


You’ll notice that this time around there’s no "w": 
that’s because instead of writing to the file, you’re 
going to be reading it. You could replace the "w" 
with an "r", but MicroPython defaults to opening a 
file in read mode ~ so it’s fine to simply leave that 
part of the instruction off. 

Next, type: 


file.read() 


You’ ll see the message you wrote to the file print to 
the Shell area (Figure 2). Congratulations: you can 
read and write files on your Pico’s file system! 

Before you finish, remember to close the file — 
it’s not as important to properly close a file after 
reading it as it is when writing to it, but it’s a good 
habit to get into anyway: 


file.close() 


Logging temperatures 

Now you know how to open, write to, and read 
from files, you have everything you need to builda 
data logger on your Pico. Click the New icon to start 
anew program in Thonny, and start your program 


by typing: 


import machine 
import utime 


sensor_temp = machine.ADC(machine.ADC. 
CORE_TEMP) 


conversion factor = 3.3 / (65535) 

reading = sensor_temp.read_u16() * 
conversion_factor 

temperature = 27 - (reading - 
@.706)/0.001721 


You might recognise this code: it’s the same as 
you used in The MagPi #107 (magpi.cc/107) to read 


from your Pico’s on-board temperature sensor. The 
readings from the sensor are the data you’re going 
to be logging to the file system, so you don’t want to 
simply print them out as you did before. 

Start by opening a file for writing by adding the 
following line at the bottom: 


file = open("temps.txt", "w") 


If the file doesn’t already exist on the file system, 
this creates it; if it does, it overwrites it - emptying 
its contents ready for you to write new data. 

Now you need to write something to the file — the 
reading from the temperature sensor: 


file.write(str(temperature) ) 


Rather than writing a fixed string in quotes, as you 
did before, this time you’re converting the variable 
temperature — which is a floating-point number, 
in other words one with a decimal point in it- toa 
string, then writing that to the file. 

As before, to make sure the data is written you 
need to close the file: 


™ Now write something to 
the file - the reading from 
the temperature sensor & 
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urechnd 


Steel 
Tyne “helt” for mare information, 


aee Tile = open{“testot<t", “w) 
=s= file.write("Hdello, Flle!*) 
2 

Sos Tile, close.) 

wee file = open("test.tat"} 

=e> Tile, rasa} 

"“Halic, Pile: 


Poh] ] 
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[ You'll Need 


>» Raspberry Pi Pico 


>» Battery Pack 
(optional) 





Warning! 


Opening a file for 
writing in MicroPython 
will delete anything 
you've already stored 
in it. Always make sure 
you've opened the file 
for reading and saved 
the contents somewhere 
if you want to keep it! 


WV Figure 2 Printing the 
stored message to 
the Shell area 
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Figure 3 file.close() 


Click the Run icon and save your program to the 
Raspberry Pi Pico as Datalogger.py. The program 


Theonery : Microfython device : ADatalogger py PUBL: 


os Ky Oo @) will only take a few seconds to run; when the >>> 
| r © 
el Sank tet ca er) prompt reappears at the bottom of the Shell area, 
[ Danalogger py click into it and type the following to open and read 
deport utiae your new file: 
! sensor_tenp = machine. ADC (machine ADC, CORE TEHP) 
L Versi fact a 3.3 / (65535) 1 = UL UL 
Peecting a ceciaor tap rand ul6é() * conversion factor file = open( temps.txt ) 
at rature = 2F - (reading - 8.TH6)/8.881771 : 
fils <capeat ‘tampa hate: w") file.read() 
10 file.write(str( temperature) | : 
LL file.close() file.close() 


You’ ll see the temperature reading your 
| program took appear in the Shell (Figure 3). 
Shel Congratulations: your data logger works! 


ee iret . A data logger that only logs a single reading - a 
ooo file.close() datum — isn’t that useful, though. To make your 


a data logger more powerful, you need to modify it 
rete teal hc pk so it takes lots of readings. Click Run again, and 


som file.read([} 
"2.49038" read the file again:. 
ses file.close(] 
Eel = 
MireP yon (Pasasberry Pi Pics) 


file = open("temps.txt") 











file.read() 
A Figure 3 Your WV Figure 4 All the vee to--)) 
file records the measurements 
temperature at the are there, but the ; ‘ ; : 
a erent formatting makes it Notice how there’s still only one reading in the 
verte CHACON Cotead file. When your program opened the file for writing 
Th Thonny - MicroPyth_ : again, it automatically wiped its previous contents 
: Figure 4 









— meaning that each time your program runs, it 
will wipe the file and store a single reading. 

To fix that, you need to modify your program. 
Start by clicking and dragging your mouse cursor 
to highlight the lines: 


Thonny - MicroPyihon device = (Dataloggerpy @ 12; 20 


O 


Fun 





Pay Lied 


| Gatadogper. py | 5 


| inpart sachine 
import utime 


reading = sensor_temp.read ul6() * 





conversion_factor 
temperature = 27 - (reading - 
@.706)/@.001721 


) sensor_temp = machine .ADC (machine .ADC.CORE TEMP) 


conversion factor = 3.3 / (65535) 
| file = open("temps.txt", "w"} 
| while True: 
| reading = sensor temp.read ul6() " conversion _facter 
temperature = 27 - (reading - @,706)/0,.601721 
file.write(str( temperature) } 
iF file. tlush{ } 
13 utine, sleep 16) 


When you’ve highlighted both lines - making sure 
not to miss any parts — let go of the mouse button 
and press CTRL+X on your keyboard to cut the 
lines; you’1l see them disappear from the program. 

Next, go to the bottom of your program and 
delete everything after: 


wee f 


file = open("temps.txt", "w") 


inte file = open("temps.txt"™) 
pom TL Le. read () 


“20. d9OF3820. 02224260, 4903820, 4903820, 0222020. 49638 ' 


wee Tile.close() 
ame | = 


MicroPyihon (Raspberry Fi Pic) 


™ To make your data logger 
more powerful, you need to 
modify it 
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Now type: 
while True: 


After pressing ENTER at the end of that line, hold 
down the CTRL key and press the V key to paste the 
two lines you cut earlier. You’ll see them appear, 
which saves you having to type them in — but only 
the first line will be properly indented so it’s nested 
as part of the infinite loop you just opened. Put your 
cursor at the start of the line below by clicking and 
press the SPACE bar four times to indent the line 
properly, then move your cursor to the end of the 
line and press ENTER. 

Type the following line, making sure it’s 
properly indented: 


file.write(str(temperature) 


Now, though, you’re going to need to do something 


new. If you close the file as you did before, you 
won’t be able to write to it again without reopening 
it and wiping its contents. If you don’t close the 
file, the data will never actually get written to the 
file system. 

The solution: flush the file, rather than close 
it. Type: 


file.flush() 


When you’re writing to a file but the data isn’t 
actually being written to the file system, it’s stored 
in what’s known as a buffer — a temporary storage 
area. When you close the file, the buffer is written 
to the file in a process known as flushing. Using 
file.flush() is equivalent to file.close(), in that 
it flushes the contents of the buffer into the file - 
but unlike file.close(), the file remains open for 
you to write more data to it later. 

Now you just need to pause your program 
between readings: 


utime.sleep(10) 
Your finished program will look like this: 


import machine 
import utime 


sensor_temp = machine.ADC(machine.ADC. 
CORE_TEMP) 


conversion factor = 3.3 / (65535) 
file = open("temps.txt", "w") 


while True: 
reading = sensor_temp.read ul6() * 
conversion_factor 
temperature = 27 - (reading - 
@.706)/0.001721 
file.write(str(temperature) ) 
file.flush() 
utime.sleep(10) 


Click the Run icon and count to 60, then click 
the Stop icon. Now open and read your file in the 
Script area: 


file = open("temps.txt") 
file.read() 
file.close() 


The good news is that your program has worked, 
and you’ve recorded multiple readings in a single 
file — around six, give or take a few depending 
on how quickly you counted. The bad news is 
that they’re all mushed together on a single line 
(Figure 4) — making it difficult to read. 
To fix that problem, you need to format the data as 
it’s written to the file. Go back to the file.write() 
line in your program, and modify it so it looks like: 
file.write(str(temperature) + "\n"). 

The plus symbol (+) tells MicroPython that you 
want to append what follows, concatenating the 
two Strings together; "\n" is a special string known 


Th Thonny - MicroPyth_ 











Hew 


© 


Pun 





[ Geetiiogyger. py | 


import machine 
import utime 


Sensor Temp = Machine. A (Machine, ADL. COME TEAF) 


conversion factor = 9.3 7 (65595) 
file = open({*tempa txt", "wh 
while True: 
reading = sender temp.read wlh|) * coaversien_factar 


temperature = 27 - (reading - G.706)/9 001721 
L File .write(str( temperature) * “ind 

file.ftlusht p 

utime, slega(id) 


al 


oon e 


Ses FILE = Gpea ("temps . tat") 
a2 file. read} 


“20.5853 nie G24 n2b, OF224n26, 822245 N78, P5953, nIb, 822244" 


see File .closeth 
cam | 
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TopTip @ 


File Storage 


Your Pico's file 
system is 1.375MiB 
in size. How long 

it takes to fill this 
will depend on 
how many other 
files you have 

and how often 
your data logger 
saves a reading: 

at nine bytes per 
reading every ten 
seconds, you'll fill 
1.375MiB in around 
18.5 days; if you 
took a reading 
every minute, your 
data logger could 
run for around 111 
days; if you only 
read once an hour, 
your data logger 
could run for more 
than 18 years! 


Figure 5 You're 
getting closer 

to an easy-to- 
read printout here 






Figure 5 






ae 





Raspberry Pi Pico datalogger | magpi.cc | 63 





TO MagPi | TUTORIAL 


cet started with 
icroPython 
estar ry Pi Peea 





Get Started with 
MicroPython 
on Raspberry 
Pj Pico 


For more physical 
computing 
projects to try on 
your Raspberry Pi 
Pico, grab a copy 
of the new book, 
Get Started with 
MicroPython on 
Raspberry Pi Pico. 
As wellas learning 
how to use 
Raspberry Pi Pico’s 
pins as inputs and 
outputs, you'll 
build a simple 
game, measure 
temperatures, 
save and load 
data to your 
Pico's file system, 
and even make 

a burglar alarm 
for your room. 

Get Started with 
MicroPython on 
Raspberry Pi Pico 
is available now 
from magpi.cc/ 
picobook. 
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[ Datskegger.py |= 


ispert machine 
import ulloe 


while Troe: 
temperature = 27 


file. flush | 
Ei. leee! 10h 


heel 
soe TLle.close| | 


See pr lati tile. reed }) 


26, BBSEa 
20, 02224 
20, 02224 
28, 82224 
26, 95854 
28 ,02224 


see file .clode| | 
ah 


SenSOr Temp =m machine. ADC (machine. ADC .CORE TEMF 


conversion factor = 3.3 / (5555) 
Tile = open( "leaps tat", 


- [reading - 8. 7000/0. 001721 


] 
"ht" } 
reading = fentar_ tenn. read wlbt |) " conwersion_ factor 
file.writeletr(temperature) * "Un'] 

1 


eee file = open("tonps.txt" 


as acontrol character — it acts as the equivalent of 
pressing the ENTER key, meaning that each line in 
your data log should be on its own separate line. 

Click the Run icon, count to 60 again, and click 
Stop. Open and read your file: 


file = open("temps.txt") 
file.read() 
file.close() 


You’ve made progress, but it’s still not right: the \n 
control character isn’t acting like a press of ENTER, 
but printing as two visible characters (Figure 5, 
previous page). That’s because file.read() is 
bringing in the raw contents of the file, and making 
no attempt at formatting it for the screen. 

To fix the formatting problem, you need to wrap 
the file read in a print() function: 


file = open("temps.txt") 
print(file.read()) 
file.close() 


This time you’ll see each reading print out 
on its own line, neatly formatted and easy to 
read (Figure 6). 

Congratulations: you’ve built a data logger 
which can take multiple readings and store them 
on your Pico’s file system! 

Your Pico’s file system works regardless of 
whether or not it’s connected to your Raspberry 
Pi or another computer. If you have a micro USB 





WV Figure 6 Now you can read all the temperatures your data logger 
has captured 
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™ You can take your data 
logger to any room and 
Nave it run by itself © 


mains charger or a USB battery pack with a micro 
USB cable, you can take your data logger to any 
room in your house and have it run by itself — but 
you'll need a way to get your program running 
without having to click the Run icon in Thonny. 

For use without a connected computer — 
known as headless operation — you can save your 
program under a special file name: main.py. 
When MicroPython finds a file called main.py in 
its file system, it runs that automatically every 
time it’s powered on or reset — without you having 
to click Run. 

In Thonny, after stopping the program if 
running, click the File menu then Save As. 
Click ‘Raspberry Pi Pico’ in the pop-up that 
appears, then type ‘main.py’ as the file name 
before clicking Save. At first, nothing will seem 
to happen: that’s because Thonny puts your 
Pico into interactive mode, which stops it from 
automatically running the program you just saved. 

To force the program to run, click into the 
bottom of the Shell area and hold down the CTRL 
key, press the D Key, then let go of the CTRL key. 
This sends your Pico a soft reset command, which 
will break it out of interactive mode and start the 
program running. Find something else to do for 
five minutes or so, then press the Stop icon and 
open your data log: 


file = open("temps.txt”") 
print(file.read()) 
file.close() 


You’ll see a list of temperature readings, even 
though you didn’t click the Run icon — because your 
program ran automatically when your Pico reset. 
If you have a micro USB charger or USB battery 
pack, disconnect your Pico from your Raspberry 
Pi, take it to another room, and connect it to the 
charger or battery pack. Leave it there for ten 
minutes, then come back and unplug it. Take it back 
to your Raspberry Pi, plug it back in, and read your 
file again: you’ ll see the readings from the other 
room, proving that your Pico can run perfectly well 
without your Raspberry Pi helping it along. 
Congratulations: your data logger is now fully 
functional and wholly portable, ready to go with you 
wherever you need to record data! 
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We design and manufacture I/O HATs with analog inputs and outputs, universal opto-isolated inputs, on-board 

relays, thermistors and RTD, battery backup, CAN and RS485, MOSFET and TRIAC and more. All stackable to 8 
layers, pluggable connectors, brass mounting hardware, H and V DIN-Rail mounts. Free 3D models, schematics 
and source code. Software includes command line, Pye: Node-RED, Open PLC, and Domoticz drivers. 
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Mike Cook 





Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, and 
Raspberry Pi Projects 
for Dummies. 
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You'll Need 


>» Stripboard 
magpi.cc/ 
stripboard 


>» 102 tack switches 
4-pin 6x6x5mm 
magpi.cc/ 
tackswitch 


>» Hex Keys CAD 
diagrams 
magpi.cc/ 
pibakery 


» Access to 
laser cutter 


» Figure 1 Our double 
box concept 








Isomorphic 
keyboard: hex keys 


Use Raspberry Pi Pico to make an isomorphic music keyboard with hexagons 


piano keyboard is an isomorphic 

keyboard. Here, the notes are laid out so 
that adjacent keys differ by only a semitone. It 
is said that such a Keyboard is easier to learn to 
play in any key. This month, we show you how 
to make a USB interfaced MIDI keyboard with an 
isomorphic layout. 


D ne alternative layout to a conventional 


lsomorphic keyboards 

While the principle of adjacent keys 
differing only by a semitone is simple enough, 
there is considerable variety in exactly how they 
are laid out. The arrangement of keys can be ona 
square erid, or an offset grid; the keys themselves 
can be square, round, or, our favourite, hexagonal. 
There are a number of different layouts that 

detail exactly what keys are where; these have 
names like Gerhard, Park, Maupin, Wicki-Hayden, 
Harmonic, Janko, C-system, and B-system. We 
are going to use the Harmonic type that was used 
by the now defunct C-Thru Music company. 


12 mm 














Top Key 





Hex Tack switch 
Spacer Matrix board 
30 mm 

Hex 
Spacer 
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| Oversize key 








The enclosure 

We came up with the concept of a two-layer 
box — this is shown in Figure 1. The top surface 

is where the Keys are. They are cut out and press 
down on the tack switches underneath. To stop 
them falling out when the box is turned upside 
down, each key has an oversize version of itself 
glued to it. The tack switches are mounted on 

a large piece of stripboard, supported by 3mm 
Spacers screwed to the middle level. Underneath 
this is a Raspberry Pi Pico board, supported on five 
30mm pillars between the base and middle level. 





Scan the Matrix 

A scanning switch matrix is a way of reading 
a lot of switches from a few inputs/outputs. Figure 2 
shows the schematic of a small 3x4 matrix. There 
are many variations on this, but we have chosen 

to use a column drive with a row input. A walking 
zero Signal is applied to the columns, and pressing 

a key connects a column to an input. As you know 
what column was low when an input was low, you 





\ {| Top layer 





acer 
| Middle layer 


| Base Layer 
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know what key was pressed. We will be making a15 
column by 7 row matrix for this project. 


The laser files 

We have started using the software 
LightBurn to produce our laser cutter artwork, 
and all the files can be found on our GitHub page. 
If you use another system, then you can get a full 
version of this software on a 30-day free trial to 
use or convert the files. Alternatively, we have also 
supplied SVG files for each sheet you have to cut. 
The top panel also includes vector engraving on the 
keys — this has to be done first at a lower setting so 
as not to burn all the way through. 


Enclosure construction 

Figure 3 shows the construction of the two- 
layer box. Note how the side with only a1.5mm tab 
sticking out goes to the middle layer of the box, 
and the 3mm tabs on the other side go to the top 
and the base. We assembled and glued the sides 
into two rings, and then we reinforced each corner 
with a small length of half round dowel fixed 
with superglue. Then we plugged up the bottom 
end with Blu Tack (tack putty) and dribbled some 
Gorilla clear glue down the joint for added rigidity. 
See Figure 4. 
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Painting 

We have come up with a new way to paint 
plywood boxes that doesn’t show brush marks, by 
using a half-inch foam brush and normal emulsion 
paint. This allows us to use paint from the wide 
range of match-pot colours, and gives a nice flat 
finish. To keep things clean from finger marks, we 
add three coats of a water-based clear matt varnish. 
We used yellow for the top and base, and matt black 
for the sides and visible edges of the box. 


Painting the keys 

Figure 5 shows the colours we used to paint 
the keys. They keys can be painted any colours 
you like, but keep the groups consistent for the 
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Box assembly 


We marked the 
sides and middle 
layer of the inside 
of the box so 

that we always 
assembled it 
consistently. 


Figure 2 A 3x4 
switch matrix 
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Figure 3 





A Figure 3 The 
assembled double box 











> Figure 4 Reinforcing 
the corners of the 
two rings formed 
from the sides 


WV Figure 5 The colours 
we used for the keys 
—- magenta and sky 

blue are the white 

keys on a piano 
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™ Once painted, you can glue 
the keys to the oversized 
key Blanks @ 


best playing experience. Again, three coats of matt 
varnish are applied to each key. Once painted, you 
can glue the keys to the oversized key blanks. We 
used a small drop of superglue in the middle of 
each and pressed down for ten seconds. Try to get 
them centralised; if not, this can be corrected with 
a disc sander. The top and bottom flat of each key 
blank should be about 1mm from the edge of the 
actual key. 


The stripboard 

We need a piece of stripboard 101 holes long 
by 58 strips high. Unfortunately, we couldn’t find 
one, so we had to make one out of three pieces of 
board. Fortunately, this could be done by buying 
just one 119 by 455mm sheet of stripboard. The 
maximum height of this board is 46 strips, so we 
cut out a101 hole by 46 strip high main piece, a 71 
hole by 12 strip, and a 30 hole by 12 strip piece. We 
also got a 58 hole by 8 strip piece for the triangular 
control button board from the same piece of 
stripboard. See our GitHub page for more notes 
about joining these together. 





The Matrix 


Figure 6 shows the first five columns. There 
are two additional diagrams showing the rest of the 
wiring on our GitHub page, but the basic pattern 
is the same. The even and odd numbered columns 
both have identical patterns of key placement and 
track breaks round them. We fitted the switch 
first and then, before soldering it, cut the tracks 
between the switch pins and surrounding the 
tracks. To make sure you have picked up the correct 
place to make the break, insert a wire through the 
place indicated, then turn the board over and make 
the break where you see the wire. 


The Matrix 2 

Make sure the tack switches are flat to the 
board when you solder them. They have a habit of 
pushing themselves out once the board is turned 
over for soldering. To make sure they are OK, solder 
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Figure 7 


one of the four pins and check. If it is not flat then 
hold down the corner of the key with your finger 
nail and reapply the soldering iron and push it into 
place. Do the same for the opposite corner. Once 
two corners are in place, simply solder up the other 
two. Then fit the 1N4148 diode next to each switch, 


eet it the right way round. 


The Matrix 3 


The long tracks of tinned copper wire with 
a black dot on them denote a joint where one wire 
enters the hole and another leaves it. Here, push 
all the wires in place before soldering them. We 
found this easier if these holes were enlarged 
slightly with a1.2mm drill. When fitting the keys, 
turn the top over and insert from the back; we 
numbered the columns and rows on the board and 
wrote the column and row number, along with its 
name, on the back of each key. We then placed a 
blank board over the top and inverted it. Finally, 
we attached each key to the top with masking tape 
so they would not drop out when we fitted the top 
— see Figure 7. 


Warp one, Mr Sulu 

One problem we encountered was that the 
top board had an inwards warp. This meant that 
when the top retaining screws were tightened, the 
top was pressing some switches. To counter this, 
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teetatetrer a Figure 6 


one or two securing holes were turned round so 
that a screw pushed up on the board, correcting 
the warping. We used a 20cm pan-head M3 
screw with a 3mm spacing and three 0.5mm 
solder tags on the underside of the board - 

see Figure 8. The solder tags allowed for fine 
adjustment, making the switch tops flush with 
the board. We had to cut away at the oversize 
key mount on surrounding Keys to ensure the 
push-up screw was not fouled. 


Part 2 


Next issue, we’ll look at the construction 
of Raspberry Pi Pico, control switches, OLED 
display, and rotary encoder, as well as how to 
wire it all together. We will also look at the 
software we need to test what we have built, and 
the final software bring it all to life. 
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A Figure 7 Use 


masking tape to stop 
the keys falling out 
when fitting the top 
to the switches 


Figure 6 Physical 
wiring of a third of 
the switch matrix 


TopTip @& 


Deburr the 
Stripboard 
holes 


When drilling 
through the 
stripboard, you'll 
notice that there 
will be bits of 
copper that could 
make contact with 
the screw. Deburr 
the holes by lightly 
applying a larger 
drill bit by hand 

to remove the 
copper at the very 
edge of the hole. 


Figure 8 Two push- 
up support screws 
and the central 
base support 
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Did you know that Raspberry Pi is g game-creation machine? There are many 
ways to write games and Mark Vanstone will show you a few to get you started 





Educational games 
author from the 
1990s, author of the 
ArcVenture series, 
disappeared into the 
corporate software 
wasteland. Rescued 
by Raspberry Pi! 
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Scratch is an ideal place to start making games, with a great online community 
of creators who share their games so that you can see how they were made 





cratch is a block-based visual editing 
T 0 p Ti p a S programming language. Instead of writing 
commands in text, you click and drag 
objects (known as ‘sprites’) and control them 
with block commands. It’s designed to make 
object-oriented programming easy to understand, 
and is a great way to get to grips with coding 
concepts. Due to its visual nature, it’s ideal for 
creating basic games and interactive stories. 
There are several versions of Scratch that 
are compatible with all versions of Raspberry 
Pi although the latest version, Scratch 3 is 
recommended for Raspberry Pi 3 and Raspberry Pi 4. 






If you want to use 
sound in your 
project, you can 
go to the Sounds 


tab. You will find a 
cat meow sound 
to start you off. 


Get Raspberry Pi ready 
It’s always a good idea to keep your system 
files up-to-date. You can either download a fresh 
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install of Raspberry Pi OS to your system card 
using the instructions at magpi.cc/imager or 
from your Terminal window use the commands 
SCM) hem e-na) ANG then Eclom-)opemlyeyter-lel(-). 1 1S 
wise to always go through this procedure before 
installing anything new on your Raspberry Pi to 
make sure you have the latest version of all the 
system files. Of course, for any installs or updates, 
you will need a connection to the internet. 





Install Scratch 

There are three versions of Scratch and an 
online editor. You can install Scratch 3 by clicking 
on Menu > Preferences > Recommended Software. 
In the Programming section, you will see Scratch 3. 
Place a tick in the Install checkbox to the right and 
click Apply. 











Your first Scratch 

If you have not used Scratch before, you 
probably want to jump straight in and make 
something happen. With Scratch, you can do just 
that. You’ll find Scratch in Menu > Programming > 
Scratch 3. You will see a cartoon cat on the right- 
hand side and a set of blue boxes on the left. Drag 
the turn 15 degrees block into the Script area 
in the middle (this is where you assemble your 
program). Click the turn 15 degrees block and the 
cat will rotate. 


The green flag 

Our rotation block is good, but what if you 
want something more? We can build a program of 
blocks by joining them together. Click Control in 
the sidebar and then drag and drop the repeat 10 
block into the Script area. Then move your turn 15 
degrees block so that it’s inside the repeat block. 
Then click Events in the Blocks palette and drag 
the when (green flag) clicked block to sit on top of 
the repeat block. Now if you click the green flag at 
the top of the window, the program will run. 


or aq = ll ill 
Customising your sprites 


In Scratch, a sprite is a graphic on the 
screen that you are controlling. You can change 








et “at 
on 











what it looks like by loading in your graphics or 
editing the image. Select the Costumes tab at 
[erOp Chile screen PhOlimiiehe /OUlcamlse ac 
painting tools to make a new image or alter the 
one that is already there. Try drawing some lines or 
filling in some shapes to see how it works. You can 
also write text. If you select items with the arrow 
tool, you can also change their colour. 


Exploring the Scratch community 
You will probably want to find out lots more 
about how to use Scratch, and there are lots of 
tutorials if you select the Tutorials section in the 
top menu bar of the desktop or online version. You 
can also get lots more help from the main Scratch 
web page at scratch.mit.edu/ideas. If you look at 
the Explore section on the website, you will be able 
to find lots of projects that other people have made 
and if you find one you like, you can see how they 
did it by selecting the ‘See inside’ button at the 
top-right corner. 
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You can load/save 
Scratch projects to 
your Raspberry Pi. 
The online version 
can save projects 
to the Scratch 
server if you log in. 


<The costume editor allows 
you to edit and design 
graphics for your games 
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M4 
Load 
rocket.py % 


import pgzrun 


myrocket = Actor('rocket', 


def draw(): 


screen.clear() 
myrocket.draw( ) 


def update(): 


myrocket.y -= 1 


pgzrun.go() 


shell 
>>> 


(COS PYPUL ON (IMTESS WOU PIMs a a 





atom aUlamy(olelm navcel-laal-mele 
Pygame Zero programs just 
press the green Run button 


BAY el-m\colel a cava salolamexele(- malcom sal=) 
Bi ave)alana=relive)emaa\.e|-|aa\-W 4-160) 
uses the two default functions 


fol ge\V Okemo lisje) k= \acvelg-1-14) 
KeVaalslal aces laremeleyel-1 K-10 mKe) 
Clee t= WkomVeclatcle)k-- lave mets re) 





2 el 
# Switch to 
> regular 
mode 


Stop Zoom Quit 





Raspberry Pi can be used to make some super games and Pygame gives you d great head start 








Top Tip — 





Even if you start 
your program with 
Pygame Zero, if you 
need a function 
from Pygame you 
can include parts 
of the Pygame 
module too! 


ne of the best ways to get started with text- 
t} based programming on your Raspberry Pi 

is to jump straight into Pygame or Pygame 
Zero. These are both available with the Python 
programming language and all three are already 
installed by default with Raspberry Pi OS. If you are 
not familiar with Python, you can get it running 
from the Programming menu by selecting the 
Thonny Python IDE. This will open up an editor to 
use Python 3. Python is easy -to learn and read, and 
this article will show you how to use it with Pygame 
and Pygame Zero. 





Cl Pygame Zero was designed to require as 
little code as possible to get a game running. If you 
launch the Thonny Editor (IDE) and type 
to load the Pygame Zero module and then 
after that, write to start the game, you 
can then save the file and run it (with the green 
play button). If you have typed the code correctly, 
you will see a black window appear titled ‘Pygame 
Zero Game’. You have written your first Pygame 
Zero game! It’s not a great game yet but that’s all 
you need to get the game engine running. 
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02 Let’s get a graphic moving on the screen. 
You will need to find a suitable image to use, 
perhaps a spaceship or little green man. Have 

a look at the ‘Graphics Resources’ section near 
the end of this feature about where to find 
eraphics. A PNG is best; you can find our rocket 
at magpi.cc/rocketart. Now make a subdirectory 
in the same place as you saved your Python file 
and call it images and put your graphic file inside 
that directory. Now load that graphic into an 
Actor object in your code. Name your graphic file 
rocket.png (you must keep to lower-case letters) 


and load it by typing (DY{aleYe <5 aime oa lek Gm ek, <-1 ae 
center=(400, 50Q) )} 








03 Now to get our rocket to display on the 
screen, we need to add some code to draw it. We do 


this witha function, so type GiielEnt@M and 


press RETURN, then type myrocket.draw()} biietarare 
make the rocket move up the screen, we need to add 


an function by typing and 


underneath type DMiseYd <a meee. If we save and run 
this program, we should see the rocket moving up 


the screen. If you don’t, check the rocket.py code 
to see what you have done differently. It may have 


some drawing left behind, so add at 
the beginning of the function. If all is well, 
you have the start of your Pygame Zero game. 


ROCKET.PY 


= Language: Python 


eee 9): 40010) 


myrocket | ('rocket', center=(400, 50°)) 


ol ar- Os 
screen. @) 
myrocket. 0) 


update(): 
myrocket.y | 


pgzrun.2o() 


Pygame Zero makes it very quick and easy to 
get games working on your Raspberry Pi, but if you 
want more flexibility you may find that Pygame is 
what you require. You will need to write a bit more 
code, but you will be able to access some functions 
like using game controllers. To start a Pygame 
program, you will need to import the pygame module 
using and then after that, make a call 


to (Fei urge @). [his starts the game engine off, 
but we won’t see anything happen if we run it. 


We make a screen for our game by calling 
a function called and 
give it the width and height that we want the 
screen to be. Once that is set up, we will need to 
start a loop (in this case a loop) to check 
that the program is still running — and in the loop 
we blank the screen, draw our graphics on an 
invisible buffered screen, and then flip the screen 
from the buffer to the visible screen. All this 
keeps happening until the user exits the program 
by using the window close icon. Have a look at 
pgtest.py to see how all this is done with Pygame. 
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Lots of Pygame game 
developers share their 
creations online like this 
game called Dynamite 


Level: 7 

Time: O-49 
score: 08750 
=) 


PGTEST.PY 


= Language: Python 


Watch your 
alevanviare! 


ss pygame 


pygame. 2) When you save 


your code, don't 
call it ‘pygame’ 
or Python will 
think that you are 
referring to the 
pygame module. 


Q: ee 


screen pygame.display. ([400, 400]) 
running rue 


punning: 
# Get events from the user 
event ~—s— pygame.event. 
~ event.type  pygame.QUIT: 
running §a.se 

# Fill the screen 

screen. ((@, 8, @)) 

# Draw a red circle at 200,200 with 

radius of 5° 





pygame.draw. €-Xel of -1-11 ha @45)> a“  @D 
(200, 200), 50) 

# Switch from buffered screen to visible 

pygame.display. 0) 


WHERE T0 
GET IDEAS 


Did you know that 
The MagP''s sister 
magazine, Wireframe, 
features a section 
called Source Code 


Both of th l Tplceaen every month with 
otn O ese €xdlN ples are very Simple, Jus Pygaiie Zee Game 


to get you started, but there are lots of amazing examples? wfmag.cc 
games that can be made with Pygame and Pygame 
Zero. Over the years, The MagPi magazine has 
featured many tutorials about making games in 
Python and has even produced three books dedicated 
to teaching Python Games by example: Retro Gaming 
with Raspberry Pi (magpi.cc/retrogaming) and 

Code the Classics — Volume 1 (magpi.cc/ctc1) which 
have many Pygame Zero example games, and the 
other is called Essentials - Make Games with Python 
(magpi.cc/essentialgames) which takes you through 
game creation with Pygame. 


# Quit the program 
pygame. () 
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With AppGamekKit you can develop professional-looking games, not just for Raspberry Pl 
but also for desktop and even mobile devices 


File Edit Search View Document Build Debug Tools Help 





9 of 
New No) oL@r-laal= 1 @imerele (<M ce- Be) gaa Revert 
of BASIC, so very easy for 
Projec loX=rellalal= 1am Komelale(=16-1r-lale! fel.age main.age 
jpaceShooter] | (SpaceShooter] — 










If you are feeling 


adventurous, you 
could try out the 
AGK features that 
allow you to read 
and write to and 
from the GPIO pins. 





#include “aliens.agc” 
#include "Level.agc” 
#include “misc.agc” 


f = | 


Begin ( ) 


_iGameState = © then HandleStart 
RGameState = 1 then HandleGame 


( ) 
ae 
ameState = 2 then HandleEnd ( ) 


Sync + 
Loop 


function Begin ( ) 
ac) ' i ing Tor cre Jame 
SetVirtualResolution ( 550, 460 ) 


CreateBackground { } 
CreateStarFeielda fF} 


ppGamekKit provides a cross-platform 
fi development system that was originally 

for PC desktops, but recently it has become 
available to download free for Raspberry Pi. You 
can use the same system on other platforms too, 
and develop on one system to run on a different 
one. You can even publish your games and earn 
money without paying any royalties. The engine 
has many tools to help you build your game, like 2D 
Sprites, 3D, physics, sound, and even virtual reality. 
This guide will get you started with AppGamekit so 
that you can explore all the features. 


Until recently, AppGamekKit was compatible 
with all Raspberry Pi computers, but at the 

time of writing, it is difficult to get running on 
Raspberry Pi 4. Some system updates are needed 
for other Raspberry Pi computers, even with the 
latest version of Raspberry Pi OS. Make sure you 
have backed up any data from your Raspberry Pi 
microSD card before you Start. 


76 | magpicc | Make games with Raspberry Pi 


[SpaceShooter] F 







o ¥ 
Compile Run Broadcast 
misc.age player.age setup.age 


[SpaceShooter] [SpaceShooter] 


AppGamekit includes 
MAU lamexole(-M-te| | Ke) axe) 
fo(=\V{=) ke) ot- ale maulamel=laal=s 


Cl First, we need to get the AppGamekit files. 
You’ll need to go to the website appgamekit.com 
and sign up for an account. When that’s done, go 
to the ‘AppGamekit For Raspberry Pi’ section in 
the ‘Classic’ menu item and download the editor 
files (they are free). Double-click the gzip file to 
open it and extract the files to somewhere suitable 
like your home directory. When it’s unpacked, 
you will see a directory called AGKPi. Inside that, 
you will find the AGK launcher. Double-click to 
open the editor. If you want to see an error log 
when it’s running, select ‘Execute in Terminal’ 
when prompted. 





02 If you try to run any of the samples 
provided with AGK, you may find that you get 
some errors. This may only be an issue at the time 
of writing as there are regular updates available. 


al i From a Terminal window, enter Etteaelaat seit, 


= a= 
= 
- , - 


a 
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<4) With the AppGamekit 
samples, you can quickly 
see how to build many 
types of games 





followed by GuClMED-hamtly4m-tels, just to make sure 
we have everything up to date. Then, if you are 
getting errors about libgles2 (graphics library), 





devi which will install the necessary libraries. 
Then enter itMneieses — this is a firmware 
Updaieycord Dib MOreexiieinetiam time Wstiall 

updates, and the reason why you should make a 
backup of your memory card before issuing this 


command. Now reboot your Raspberry Pi. 





a listing of the base code you need to start your 
game. Run it and you will see a black window open Feeling brave and 
with the title ‘test’. want to run AGK 


on a Raspberry 


Load a sample Pi 4? Check out 
A good sample to start with, to make — ——— — — — the forum post at: 


Sure everything is working, is the Space Shooter magpi.cc/agkpi4 
game. Select the Open icon on the toolbar of the The sky's the limit for instructions. 
editor and then navigate to the SpaceShooter Have a look through the samples to see the 





directory, which is found in the Games folder range of what AGK can do. You will find a huge 
inside Projects. Open the .agk file and you will range of tutorials at magpi.cc/agkyt and there is 
see several files open in the editor. AGK uses a a full user guide at magpi.cc/agkguide. There is 
language very much like BASIC, so if you have also an active and helpful community forum at 


used BASIC before you should be right at home. If |= magpi.cc/agkforum where you will find more hints 
you haven’t learnt BASIC, then it’s quite easy as it and tips to help you on your way. If you are having a 


was designed for beginners. problem with something, you’ll find someone who 
has solved it and will tell you how. Don’t be afraid to 
| = ad La el get stuck in and just start coding: the compiler will 





give you feedback on anything you get wrong. 

Run the game 

If everything has gone well with the install 
and updates, when you press the green Run arrow 
you should see a window open up titled AGK and a 
Start Game screen with spaceships floating about. If 
you don’t see that, then check the Terminal window 
that launched the editor to see if there are any 
errors. You may see some warnings there anyway 
as some of the shader modes are not supported on 
Raspberry Pi, but the game should work fine. Start 
the game by clicking the screen and move the player 
ship up and down with cursor keys. 


Make your program 

Now you have the editor building a game, 
why not start your own? Start a new project by 
clicking the New icon on the toolbar. You will be 
asked for a name for the new project and a base 
path. Select the folder icon to the right of the ae ig see cae cecat nar aaae feauhicsineiall Blenders 
base path input box, and navigate to somewhere ee See legit sf ORE 11 blend B Dist a snae o 
Sitable in Stes .OLumlo 111 Creme CtOigms eleerereare lender projects on Raspberry ‘i's website (ma ypi.cc/blenderproject: 
and you will see a new file called main.agc open 
in the editor. In that file, there will already be 
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This game engine is for storytelling. Use Raspberry Pi to combine words, 
images, and sounds to create interactive visual novels and life simulation games 


The Qu 








Ren'Py scripting 

is quite similar to 
Python, but if you 
need to embed a 
Python program 
inside your Ren’Py 
game, you can do 
that too. 


esriion 


From the Ren’Py Launcher 
you can access all the parts 
of your project, edit scripts, fii 


FeValoMolUliKomielelme|-laal= 





vew Project 


Tutorial 


PROJECTS: 










Actions 
Javigate Scrip 


Check Script (| 


Change/Upaal = 


D e lete D> ersist Ja t 


Force Recompile 


and use. You can even share your creations 

without paying a penny in royalties or 
licences. Ren’Py includes a simple scripting 
language to control the flow of your story and add 
interactivity to the pages. The engine also includes a 
wide selection of animation and transition effects to 
bring your games and graphic novels to life without 
needing to learn complicated animation software 
and supports the most common graphics and sound 
formats like JPG, PNG, MP3, and a whole lot more. 


R en’Py is open-source and free to download 





Cl First, download the install files from the 
Ren’Py website at renpy.org/latest. html. You will 
need the .bz2 version for Raspberry Pi. When it 
has downloaded, double-click to open the archive 


78 | magpi.cc | Make games with Raspberry Pi 


Active Project 
mM File 
Cript rpy 
Opt ONS. Pp 
UL py 
reens.rp 
ll script files 
1@) oX=1 a BY(ole lm e) ge) (=tea Nietril 
peewee! 10) UISTIDUTIO! 
and see how it will a 
Koo) an alsanimaelars UP Ole 
\ | ePTa } 
3enerate Translations 
Extract Dialogue 


Munch Project 





and extract it to a suitable place such as your 
home directory. You will also need to download 
and extract Raspberry Pi support files from the 
Additional Downloads section. Once this is all in 
place, you will find a file in the directory you have 
extracted called renpy.sh. Double-click this file 
and select ‘Execute’. After a few seconds, you will 
see the Ren’Py Launcher open. 


02 Ren’Py includes a getting started tutorial, 
which is probably the best place to begin. By 
selecting the Tutorial project from the launcher, 
you will be introduced to Ren’Py’s features by 
Eileen. She will show you how to start a new 
project and the ways to set colours and screen 
Sizes) (ene are dis@ seenols 1m ime TulOnal to 





. a of P 


Eileen 






In this tutorial, we'll teach you the basics of Ren'Py, so you can 
make games of your own. We'll also demonstrate many features, 
sO you can see What Ren'Py is capable of. 


cover adding your images, text, and sound to your 
pages. It then goes on to creating interactions and 
transitions to make your game engaging for your 
audience. Have a look at the Choices and Python 
section to see how Scripting is used to ask 
questions and branch to different options. 


03 Going back to the Ren’Py Launcher, start a 
new project with the ‘Create New Project’ link on 
the left-hand side. You will then be asked where 
you want to save your project and what it should 
be named. Next, choose what screen resolution 
you want your production to use and the colour 
scheme that you would like. After a short pause 
for processing, your project will be created and 
listed with the tutorial in the Projects section in 
lee Lai ulinnelmenn. 


04 Start scripting the game by selecting the 


‘script.rpy’ option under Edit File in the Launcher. 


It will ask you to select the editor you want to use 
dicihen ODeInit@e cenipI Tiel iiere VvoUlecin 
make changes to the default script. When you 
want to test your changes, select your project and 
Launch Project, then select ‘Start’ from the list on 


the left of the window that opens. If you make 
changes to your script, you can then press 
SHIFT+R to reload your script and start the game 
again. If you need further help, select the 
Documentation link at the bottom left of the 
Launcher window, or check out the forums 

at magpi.cc/renpyforum. i 


SOUND RESOURCES 


A 
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Ren'Py includes a tutorial 
where Eileen talks you 
through all the features of 
the system 


If you need to find sounds for your games, you can get a whole range of sound 
effects and background soundtracks from freesound.org, zapsplat.com, or 
musopen.org/music, all of which provide free downloads. 

You may need to edit your sounds, in which case use Audacity - available for you 
to install using sudo apt install audacity from your Terminal window. 


V_ Audacity enables you to edit sound files in a variety of formats such as WAV and MP3 


Tt/\ $i, + 4 
OQ eae dae we 
o@ o MOC wie im 


ol Capeure input cermanal (0 inte 


4 





chet to Start Vortereg 2-12 A a 
44) 4 a _ 
@/8919/Q) Pi 


+ | 2 fiberee) Recording Chan ~ ie) Speakent (Reset High Deterati 
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pi-top |4| Robotics Kit 


and Expansion Plate 





MOTORS: 

2 x 12V high- 
torque geared 
motors with 
Hall effect 
sensor 
tachometers; 
2 x modular 
servo motors 


SENSORS: 

HD 720p wide- 
angle camera 
module; 1 x 
ultrasonic 
sensor 


COMPONENTS: 
Chassis 
interface 

plate; 25mm 
Durable omni- 
directional 
castor wheel; 
2x*74mm 
wheels with all- 
terrain tyres; 
50+ aluminium 
plate 
construction 
pieces; 200+ 
nylon quick- 
build rivets 


EXPANSION 


PLATE: 
Accelerometer, 
gyroscope, and 
magnetometer; 
4x6P12V DC 
motor ports; 
4x 3P servo 
motor ports; 2 x 
USB 2.0 ports; 
camera (CSI) 
and display 
(DSI) ports; 

8 x digital and 
4 x analogue 
sensor ports 
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> pi-top » magpi.cc/pitoprobot » From £187 / $200 


Build dg range of robots with aluminium plates and reusable rivets, 
then control them with Raspberry Pi and pi-top [4] DIY Edition case. 


This kit clicks with Lucy Hattersley 


robot that complements the pi-top [4] 

DIY Edition case. It promises to be a sturdy 
and versatile building platform, with competent 
software and good educational chops. 

And it delivers. Inside the box is a series of 
aluminium plates and plastic rivets that act a 
little like LEGO Bricks meet Meccano. Two rivet- 
compatible servo motors and two encoder DC 
motors, plus a webcam and ultrasonic distance 
sensor. Everything you need to build a wheeled 
robot that can see and sense the world around it. 


p i-top [4] Robotics Kit is a long-awaited 


A plan comes together 

We reviewed the pi-top [4] DIY Edition 
(magpi.cc/pitop4review) back in The MagPi issue 
99 (magpi.cc/99). At the time, we were impressed 
with the build quality, but noted the oddity of the 
built-in battery and 128x64 OLED display. 

Once clipped into the Expansion Plate on the 
robot, it all makes sense. The pi-top [4] case 
powers both Raspberry Pi and the motors in the 
robot; the OLED display provides feedback on the 


WV The innovative rivet 
system enables you to 
connect aluminum plates 
and build the robot 


IP address and remaining battery level (we got 
around two hours of use). The kit tested comes 
with an Expansion Plate that connects to the 
bottom of the pi-top [4] DIY Edition case and 
breaks it out into several control ports. 


Making robots 

Thanks to the rivet system, you can get creative 
with your robots. Three designs are included: 
Alex, a regular wheeled robot with a pan-tilt 
mechanism for the camera and ultrasonic sensor; 
Bobbie uses the servos to control two ping-pong 
ball grabbing pincers; Prax is angled in a vertical 
position and the servos create a moving face fora 
desk-based interactive assistant. Instructions for 
all three builds are available as a PDF download 
from the pi-top Start website (pi-top.com/start) 
and it’s a good place to get an overview of how the 
builds work. 


Going further 
Each build took us around an hour. When the build 
is complete, you attach a pi-top [4] DIY Edition to 
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<The “Prax” design uses 
the components to 

build an interactive 

desktop assistant 


M Superbly designed with a clever rivet construction system 
and seamless integration with pl-topOS and Further courses @ 


the Expansion Plate and insert the cables to connect 
the electronic parts to the Expansion Plate. 

Here is where pi-top [4]’s on-board battery and 
OLED display spring into useful action, providing 
network information that you can use to quickly 
SSH into the robot. 

Pi-top has clearly put a lot of elbow- 
erease into its pi-topOS and its Further 2.0 
system (magpi.cc/further). The pi-topOS 
ensures elements like SSH are enabled by 





default; along with baked-in support for the 
hardware components. 

The Further website has demonstration code to 
follow, and you can SSH directly to your robot from 
the Further website and run the interactive code 
examples directly from the web. Students can log 
in separately and collaborate on code and practise 
programming techniques together. We enjoyed 
the coding courses and challenges, and integration 
with OpenCV for object and face recognition. 

Moving beyond the Further educational port, 
you can code pi-top [4] Robotics Kit directly with 
the pi-top Python SDK (magpi.cc/pitopsdk) and 
there is support for ROS (magpi.cc/pitopros) and 
Microsoft’s .NET (magpi.cc/pitopnet). 

There’s a lot here. First of all, the whole kit is 
not particularly cheap if you include the price of 
the pi-top [4] DIY Edition and a Raspberry Pi 4. It 
is, however, superbly designed with a clever rivet 
construction system and seamless integration with 
pi-topOS and Further courses. All in all, pi-top [4] 
Robotics Kit is plain nice to use, and will sit neatly 
into an education environment. Good job. 
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A_ The pi-top Robotics 

Kit designs are sturdy. The 

“Bobbie” design uses servo 
motors as two pincer arms 


<The pi-top [4] DIY 
Edition sits on top of the 
chassis as the brains and 
battery of the robot 





Verdict 


Very high-quality 
robotic education 
kit, with an 
innovative rivet 
construction 
mechanism and 
well-thought-out 
software. It’s been 
worth the wait. 


0. 
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10 Amazing: 
4 Raspberry Pi Smart Watch 
Wearable wc. 


With screens getting smaller and smaller, discreet and wrist-bound Raspberry Pi 
builds are easier than ever to do. This Smart Watch build is a very fun example. 


projectS Sum 


oe > Social media 
Ways to wear your Raspberry Pi with pride without the 


internet 





s Raspberry Pi is so small and draws so little power, 
it’s a perfect device for powering more complex Offline socialising 
wearable projects. We’ve done cosplay stuff with it 
in the past, and here are some other incredible projects that 
let you wear your Raspberry Pi. 





This art piece made full use of 
wearable tech by having interactive 
objects all over these coveralls. 
This allowed for social media-style 
interactions in real life. 





ff 
» magpi.cc/socialwear — . 
x re = 
<Pip-Boy built 
from scrap 


ee 


u 


pALLOUT Pip Boy * . 
ig _— Pa 
F i 


y 


Apocalyptic wrist computer 


“Al You can buy official Pip-Boy cases, 


a / or 3D-print carefully crafted models. 
‘a3 : 


ma However, the recycling nature of 
this project makes it a firm favourite 
of ours. 


magpi.cc/pipboyscrap 





4 PiGlass Wearable Tech Projects 





Smart vision Want to see more wearables, and maybe 
? 

We maintain that Google Glass was cool, so seeing excellent DIY mene sa VONIS ere CRECr OUR Wediayle 

versions using a Raspberry Pi is always a delight. This one packs Tech Projects by Sophy Wong and our 

in a lot of extra features as well. sibling mag, HackSpace Magazine: 

magpi.cc/piglass magpi.cc/wearableprojects 
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This is sure to impress folks when you're at an event (whenever they come 
back) or when you're the newbie in the (geeky) office. 


wae is a o # aetna = 
FEq® hry etree ae et 


iy "Racecar ‘A Fe 
stations) 7. eae 





We like the very 1980s movie kid inventor look of this DIY radio that fits on your 


wrist. Don't be rude, though: bring headphones to listen! 





Need a wrist-mounted touchpad with multi-touch gestures? Then look no 
further than Zack's cyberpunk-inspired gesture pad. 


MagPi 





This Raspberry Pi Zero project is simple yet cool, and we think it 
would make for some great music video footage. 


This more conspicuous take on a 
pair of smart glasses can be used 
on multiple types of headwear. It’s 
also completely open. 





Hows it Ls 





Real-time translation, while not 100% accurate, is quite 
impressive. Using this AR-like Raspberry Pi glasses system, you 
can use it to try to talk to real people. 
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Learn Visual Studio 
Code with Raspberry P1 


Discover the best tutorials and resources for Microsoft's development environment. 
By Lucy Hattersley 








Microsoft Microsoft’s Visual Studio 

Code is a modern text 
Price: editor and IDE (integrated 
Free 


development environment). 
Back in 2019, StackOverflow 
reported a massive leap in 
popularity for Visual Studio 
Code. It immediately took 
the IDE number one spot with 
over 50% of respondents to 
their annual survey using it 
(magpi.cc/so2019). 


magpi.cc/vsintro 


Visual Studio 


Getting started with 
Visual Studio Code 


Visual Studio Code is available 


for Raspberry Pi and can be 








easily installed in Raspberry Pi 
OS. Click on Menu > Preferences 
> Recommended Software and 
choose Programming from the 
sidebar. Scroll down and place a 
tick next to Visual Studio Code 








In these videos, Ornella 
Altunyan walks you through 
the user interface and settings, 


and click Apply. 
Open Visual Studio Code 


(under Programming) and click 


Help > Introductory Videos. 


with tips and tricks. Once 
you’ve done that, click User 


Guide in the sidebar to start on 


the documentation. 


Grolelsmasiselenaersts 
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Bookmark these pages and 
return to them while you code 


KEYBOARD SHORT CUTS 

FOR LINUX 

Worth printing out if possible, but 
certainly keep these keyboard short 
cuts bookmarked while you run and 
debug code. 

> magpi.cc/vscodeshortcuts 


AWESOME VSCODE 
This GitHub page by Viatsko has a 
curated list of excellent packages 


and resources, all placed into handy 
lists and sections. 
> magpi.cc/awesomevscode 


VS CODE CAN DO THAT?! 

This website by Burke Holland and 
Sarah Drasner is a list of interesting 
things that VS Code can do. 
Genuinely fascinating. 

> vscodecandothat.com 








Microsoft 





Price: 
Free 


magpi.cc/ 
vscextensions 


Set up your extensions 


Once you’ve installed Visual 
Studio Code, you will want 
to investigate extensions. 

A huge array of additions to 
the base program enable you 





Extension Marketplace Fh | ema 


eee e 








fe rsear Der peers orl Yeceed Weeder tebe Hang’ ober eden 








VSCode Power 


Ahmad Awais 


Price: 
£35/$50 





vscode.pro 


In our experience, most of 

what you need to know can be 
found in the extensive Visual 
Studio Code documentation and 
introductory video tutorials. 


a eo: 


VSCode Power User 





to add support for languages, 
debuggers, editing assistants, 
and general tools. 

Choose View > Extensions 
from the menu bar inside 
Visual Studio Code (or press 
CTRL+SHIFT+X) to see 
the Extensions interface. 

By default, it will show 

some of the most popular 
extensions. The Extension 
Marketplace Documentation 
has a great overview of how to 
search for, install, update, and 
remove the extensions. fH] 


If you want to deep-dive 
into Visual Studio Code with an 
online course, then there is one 
that everybody recommends: 
Ahmad Awais’s video tutorials 
called ‘VSCode Power’. 

Ahmad is an entertaining 
course leader and the video 
tutorials are engaging and fun. 
The course covers everything 
from the basics, and setting 
up Visual Studio Code, 
through version control with 
GitHub and a professional 
extension setup. Hl 
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Three websites that 
get you up and 
running with Visual 
Studio Code 


fe on Aaabarry F 


Bresprery Pi 


VISUAL STUDIO CODE ON 
RASPBERRY Pl 

Microsoft has created its own 
guide to installing and running 
Visual Studio Code on Raspberry 
Pi. A great place to start. 

> magpi.cc/ 
vscoderaspberrypi 


VISUAL STUDIO CODE 
AND HTML 

Codecademy's article on 
using Visual Studio Code to 
build a basic HTML document 
walks you through setting 

up development folders and 
adding files. 

> magpi.cc/vscodecademy 


HOW TO USE VISUAL 
STUDIO CODE 
Flavio Copes has written a 
great introduction to Visual 
Studio Code that works 
through installation, setting up 
fonts and workspaces. 
> magpi.cc/flaviovscode 

© 4 
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ME agri | INTERVIEW 


Zack Freedman 


Zack loves wearables, and now makes them 
full-time on YouTube, among other things 


> Name ZackFreedman | >» Occupation YouTuber 





> Community role Maker | »URL magpi.cc/zackfreedman 


any people dream of away — people would spend more making videos about 3D printing 
Mi being a YouTuber or time online, substituting and DIY electronics, producing 
online content creator streams for meetups andvideos — videos and streams to show 
of some kind. Zack Freedman for talks. So, I started making different parts of the stuff- 
basically stumbled into it. YouTube videos to promote making process.” 
“T used to be a freelance myself, and people watched — 
prototype developer in New York not many at first, but out of What is your history 
City,” Zack tells us. “But when... nowhere, lots of people, way with making? 
all the meetups and conferences more thanI expected. The I tried and failed to build tech 
[shutdown last year], the clients videos ended up doing better projects a number of times: 
dried up. I knew that social than the prototyping contracts! websites as a kid, RC cars asa 
interaction wouldn’t just go Now, I’m a full-time YouTuber, teen, a Nerf ammo counter in 
college, and many more dead- 


A ‘ yas.  . end ideas that my very generous 
Ww ta parents supported. I even got 
into engineering school, only to 
find that it was all math, and | 
hate math. I’ve never been a 
ereat student, even when I want 
to learn the topic — I get 


M |'ve built a crazy 
number of 
projects for fun 
gnd work, at least 
200 in total @ 


P Some of the amazing 
projects that Zack has put 
together over the years 
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obsessed with something like 
Nerf blasters and plunge 
hundreds of hours into the rabbit 
hole, but I just can’t force myself 
to systematically learn anything 
soup to nuts. | was spinning my 
wheels and felt like a moron. 

Everything changed during an 
internship in the summer of 2011 
— I was working for an app store 
startup (twas a different world) 
and got assigned to write for the 
company blog. At the time, 
‘appcessories’ — gizmos designed 
to pair with cell phones — were 
the Silicon Valley hotness, and 
my research brought me to 
Hackaday, where someone had 
turned a $25 toy into a wearable 
computer. | thought that was the 
coolest thing ever, so I instantly 
got obsessed with turning myself 
into a cyborg. 

Since then, I’ve built a crazy 
number of projects for fun and 
work, at least 200 in total. It was 


all going pretty well until people 
started coughing a lot and 
pretending it wasn’t dangerous, 
and here we are! 


When did you first learn of 
Raspberry Pi: 

I’m by no means an early 
adopter, but a MakerBar member 
was. He pre-ordered a huge pile 
of original Raspberry Pi before 
the first release, so I got inon 
the ground floor. [As] I was 
obsessed with wearable 
computers, Raspberry Pi was the 
only pocket-sized device below 
S500 that output 480p composite 
video, so it instantly became a 
critical part in my projects. One 
of our members learned that 
Eben Upton himself was 
travelling through the East 
Coast, so we invited him to 
speak at our hackerspace and 
somehow got a meet-and-greet 
with the team. I showed off one 


of my earliest wearable 
computers and Eben signed a 
Raspberry Pi for me. I put itina 
frame. It’s one of my most 
prized possessions. 


What was your first 

Raspberry Pi project? 

My first Raspberry Pi project was 
a wearable computer built out of 
a Vuzix AV230, an original 
Raspberry Pi, and a USB battery 
pack. It wasn’t the most useful 
device... still, it was an authentic 
fully functional wearable 
computer, the kind that took 
MIT geniuses years of work and 
thousands of dollars onlya 
couple of decades earlier. It was 
the springboard that helped me 
broaden my knowledge and build 
more projects; as I printed better 
enclosures, designed better 
electronics, and experimented 
with different control devices, | 
filled out my skills. Hl 
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A The Data Blaster is a very 


funky cyberdeck using 

a Raspberry Pi 400. We 
like the sporty handles for 
when you need to run 
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This Month in 
Raspberry P 


#MagPilVonday 


Amazing projects direct from our Twitter! 


Stan Droltriey 
OmutriewStan 
Replying ta mi Thebtagt 


Added a claw and a y-axis camera servo for my internet 
controlled (@Sphero RVR. 


very Monday we ask the question: have 

you made something with a Raspberry 

Pi over the weekend? Every Monday, our 
followers send us amazing photos and videos of 
the things they’ve made. 


Runs on Raspberry Pi4 + Surrogate.tv SDK. 


Here’s a selection of some of the awesome © aa 
things we got sent this month — and remember to Telescope esting lastnight | 
WS PR er) a Pe ‘an pay, Warn a | ued 
1 sending data to Stelarium Planatarum., 
follow along at the hashtag #MagPiMonday! H sed prada neindpnley aie nee 


‘ e Captured Alkaid|Uirta Major 
Anianes, Mars, Venus and Cnescent moon 
rials ? ee 





01. This robot can be controlled over the 
internet! Hopefully it doesn't grab the 
router's power cable. 


02. Astronomy and Raspberry Pi are two 
great things that go great together. 


rip yi ti 
03. Ravi has been doing some amazing 
things with flying Pico projects! 


Raspberrypi pico based #piwings flight controller. as 
@STEM education platform 


04. This is proper science fiction stuff / = — ~~ 9 
—- hopefully we can get portable : ‘ | ; 2 
versions soon. 


05. Pi Wars is still going, even if it is 
currently a remote event. 


06. This is avery cool project from one of 
our regular writers, PJ. 


07. CutiePi is a cool tablet project that we 
love seeing. 





08. Thenumber of Pico applications is 
continually rising. 


09. This microscope Is very cool and 
powerful Apparently, that is the stinger 
on a stinging nettle! 
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Michael Plek 
fa TheCasual—nge W) Srian cortell = 


am ta 


Replying to i Thebag?i 
| made an ultra compact computer that folds up into a 


: : he first heats of #PiWars #RemotePiNoon were run. 
tube! Powered by a raspberry pi 4. Full build here: 


he event was hosted on a Pi 4 & the robot have Pi 3 
As as their brains #MagPiManday 
Jasper was our arena kitten. 


The Nomad Computer 


World's Kost Compaectmuoged off the grid Camputer, The goal of this project 


Rephang te G0 
Verified injection parts for the soon-to-be-shipped 


CutiePi tablet (cuticpi.1o), also completed the battery 
standby time test in 8 hours 50 minutes from a single 


& PY Evenes charge Eas 
L gpharPEvans 


RenbAng to w Thebes Hraspberrypl #computemodules #opensourcehardware 


My piMac project edges towards completion. Power ~ 
button, sound and camera all working. 


Steward Watkiss 
rs Devo Wass 
Repharey bo wel 


LaF 


I've been working at getting a RC controller working 
with a Raspberry Pi Pico. 

Fairly successful, | get the occasional invalid reading, 
but managed to get it working reliable enough. 


youtu.be/kCZb6CD6Vgg 


FRaspbernryPiPico #MagPiManday 


Reming bo &Tiehiage 
AL Remete Contr Respteery FA Pio 


lam still working on by Raspberry pi based microscope. gh The Raspberry Mi Pico does mot come with any kind af 
Uses a Pi 4 and les die snute for focus. rats PA La CCC eee 
my own Python based GUI. | need to sort out the ——————— 
illumination and working on a moving stage. Can you 

guess what the image is? (@)TheMagPi 


& yon ort 
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Maple Syrup P1 


A Google Coral smart camera 


mart camera tech is something that has 
been around for a little while, although it is 
very often under-utilised for many reasons. 
Ricardo de Azambuja is making a fresh attempt to 
use it in a practical and exciting manner. 

“Maple Syrup Pi Camera is part of my research 
project,” Ricardo tells us. “I’m one of the 25 
TRAIN@Ed Research Fellows at University of 
Edinburgh. I am working on a project focused on 
helping local tourist attractions to better manage 
tourist flow, still GDPR compliant by design. My 
solution is to process information in the camera 
without ever saving or transmitting personal data. 
In addition to that, I wanted something open- 
source that could be customised, and as low-power 
as possible, allowing it to run a full day on an off- 
the-shelf power bank. Raspberry Pi Zero W is my 
go-to IoT device and, together with the Google Coral 
USB Accelerator, it has become my powerhouse for 
machine learning inference.” 

The Coral USB Accelerator attached to Raspberry 
Pi contains an Edge TPU processor which allows 
for offline TensorFlow models to run. It has some 
similar tech to the AIY Vision Kit that Google 
released a little while back. 

If you’re interested in reading about how it works 
in more detail, you can head to Ricardo’s project 
page at magpi.cc/maplesyrup. 





<4 The finished device is 
fairly small 


V_ Thecase holds a 
Raspberry Pi Zero W 
and a Camera Module 





WV The Coral TPU is mounted 
simply on the back 
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LITE ERRY 





Lite Berry 


The design of the Nintendo Switch is very appealing for many folks who play games, 
so this kit that helps you turn a Raspberry Pi CM4 into a handheld gaming powerhouse 
using the same form factor looks quite cool. 


kck.st/3ivYCVY 





PIRELAY 3 CHANNEL 


allows the user to connect Raspberry Pi up to 8 appliances 


4.3 Capacitive 
touch screen LEG 


Standard 


Relay Status 
40 Pin GPIO 


indicator 











P1Relay 8 


This board, which is being made in association with SB Components, really expands 
the loT uses of a Raspberry Pi. As its name suggests, it adds eight relays and even has a 
built-in touchscreen that controls each one. 


kck.st/3qAzLCg 
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Your & 


Letters 


Backwards compatibility, part two 





The 
THIKA ALUMNI 
Trust 


ESSE QUAM VICDERI 


I am the Chair of a small charity, The Thika Alumni Trust, 
that helps build e-Learning Centres in schools in Kenya. 
Typically a 50 desk environment consists of four Raspberry 
Pi Internet-In-A-Box (IIAB) Servers and 50 Raspberry Pi 


Desktops. We also encourage schools, via Kenyan Raspberry 


Pi Code Club champions, to hold local code clubs. We 
provide help and support with experimental kits and any 
old IT equipment in our possession. 

Old Raspberry Pi computers are wonderful for Kenyan 
school children to learn coding skills and also to build 
robots etc. Following on from the article by Rob Zwetsloot 
in The MagPi 107, in a similar vein I am appealing to any 
Raspberry Pi enthusiasts out there, who may have an old 
Raspberry Pi in their possession which they no longer have 
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a need for, to send them to us and we will transport them to 
Kenya for use by school children in Kenya. You will be 
helping enormously in enhancing ICT skills of students in 
the developing world. 


Harper vid email 


If you missed Rob’s Final Word in the previous issue, he talked 
about how older Raspberry Pi still work just fine, and can be 
used for a variety of project types. Organisations like The 
Thika Alumni Trust are able to do amazing things with an older 
Raspberry Pi, so if you’re not sure what to do with one, you can 
always check out their website here: thethikaalumnitrust.org. 
You can also email them at: ttatenquiries@gmail.com. 


The Martians 


I read the article about Avra Saslow and her emulation of the 
Mars 2020 helicopter with interest. 

I’ve made a short video of my ‘homage’ to Perseverance and 
Ingenuity. It is far, far less sophisticated, but tries to emulate rover 
and drone: magpi.cc/legomars. 

Architecture is a Raspberry Pi 3B, LEGO Mindstorms, BrickPi, 
CrazyFlie, OpenCV, and Python. 

Raspberry Pi controls the rover and provides the video feed - the 
OpenCV component currently runs on a laptop and communicates 
with Raspberry Pi over oMQ. Porting the OpenCV code to Raspberry 
Pi is a future step. 


Nigel vid email 
This is an incredible build — Raspberry Pi is perfect for OpenCV as 


well, so this should be an easy port. Keep us updated with what 
you’re making as we’d love to cover it more in the magazine. 
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More Raspberry Pi 400 





I’ve been wanting to get a Raspberry Pi 400 for a while 
now. However, with all the different keyboard types 
that were being released, I was waiting for a Swedish 
version. Is that on the cards, do you know: I’d be fine 
with a QWERTY keyboard. How long should I hold out 
for one? 

Tuisku vid Twitter 


Good news: there are now some new variants of 
Raspberry Pi 400 including a Swedish one. It's joined by 
keyboard layouts for Portugal, Norway, and Denmark. 
A Japanese version is coming soon for people looking 
forward to that as well. 

Check out more at the following blog post: 
magpi.cc/new4oolayouts. 


Contact us! 


> Twitter ©@TheMagPi 


> Facebook magpi.cc/facebook 
> Email magpi@raspberrypi.com 
> Online raspberrypi.org/forums 
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HackSpace 


TECHNOLOGY IN YOUR HANDS 


id i) .\07.74)\\| = 
#7 MODERN MAKER 












M1 


MAA 
~ x 
RENE 


A MARTY 
THE ROBOT V2! 


IN ASSOCIATION 
WITH ROBOTICAL 








XN 


“Marty the Robot is the best-value 
humanoid robot that can offer the 
breadth of learning progression from 


screen-free coding through to Scratch 
and Python’ - Robotical 


We reviewed Marty last issue and 
thought tt was great, describing itas a 
deceptively powerful robot with a cute 


| 


design. Heres your chance to win one.. 


Head here to enter: magpi.cc/win | Learn more: robotical.io 





Terms & Conditions 


Competition opens on 28 July 2021 and closes on 26 August 2021. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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_ the 


COMPUTERS 


BRITAIN 


“The Computers that Made Britain 
is one of the best things I've read 
this year. It’s an incredible story of 
eccentrics and oddballs, geniuses and 
madmen, and one that will have you 
pining for a future that could have been. 
It's utterly astonishing!” 








» 
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THAT MADE 


- Stuart Turton, bestselling author 
and journalist 
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Buy online: wfmag.cc/ctmb 
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amazon. 
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Our place 1n history 


Computers go back d long way, By Lucy Hattersley 


recently about early computing. 
My mother-in-law was a 
programmer (but has never 
really used a computer). This 
was back when ‘computer’ was a 
women’s job description. 

My father-in-law also used to run 
Simulations back in the 1970s on what 
turned out (after a long chat and some 
online digging) to be an IBM 
System/360 (magpi.cc/ibm360). He 
didn’t personally program the 
machine; he wrote down instructions 
for the simulation on a form, another 
person punched the hole cards, and 
then the programmer ran them 
through the computer. The results 
typically came back a week or so later. 

There followed a surprisingly 
informative chat about the history of 
computing covering all the usual 
bases: Charles Babbage, Ada 
Lovelace, Alan Turing, John von 
Neumann, and early proto- 
computers like the Difference and 
Analytic Engines, and orrery devices 
like the Antikythera Mechanism. 

They talked with pride about 
Lyons LEO (Lyons Electronic Office, 
magpi.cc/leo), a computer I hadn’t 
heard of but intend to learn more 
about. It was the first computer used 
in acommercial business setting. 
LEO was modelled closely on 
Cambridge’s EDSAC, which I do know 
about — that was designed by Sir 
Maurice Wilkes, the person whose 


was chatting to my in-laws 
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name adorns the office building I 
often work in. 

They have parts and articles on 
LEO at The Centre for Computing 
History (magpi.cc/tcch) in 
Cambridge, which has now reopened 
and I can’t recommend it highly 
enough. I'll be heading down there to 
take a look. 

We tend to think of computing as 
ultra-modern and, obviously, 
forward-thinking. Yet there is the 
weight of history behind our 
technological toys. We had just 
visited Enderby’s Wharf and, 
following a drink in Enderby House, 
there followed a chat about the 
history of underwater cabling. The 
first telegraph cable across the 
Atlantic was produced there, and 
much of the world’s subsea 
communication cables were made in 
the area. Alcatel Submarine Networks 
is still based around the corner. 

It often comes as a Surprise to 
folks that most of the internet traffic 
isn’t whizzing around in space, but 
bouncing along vast undersea cables. 
You can take a look at all the wires 
in this interactive map: 
submarinecablemap.com. 

Learning how the mystical world 
of technology works helps us to 
eround (or even submerge, in this 
case) folks to reality. Rather oddly, 
we need to take the magic out of 
computing. To bring it away from the 
realm of “any sufficiently advanced 


technology is indistinguishable from 
magic”, and into the practical world 
where computing becomes a tool we 
can control. 


fM™ Rather oddly, 
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Raspberry Pi 

It gave me great pride to show my 
in-laws Raspberry Pi and explain 
what each constituent part was. 
They were amazed by how small it 
was, especially Raspberry Pi Zero. 
Having this historical perspective 
helped me explain to them why 
Raspberry Pi was so important. It 
continues the UK’s long tradition of 
designing, and building, its own 
computers. Raspberry Pi is vital to 
ensure the existence of a future 
generation of programmers, by 
putting the power of physical 
computing into the hands of young 
learners (of all ages). 


Lucy Hattersley 





Lucy is editor of The MagPi magazine 
and loves computers, but thinks we 
should have gone with ‘difference 
engine’ instead. 


magpi.cc 


American 
Raspberry Pi 
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e Displays e Cases e Project Kits 
e HATs e Arcade 


e Sensors @ Swag 


e Add-on Boards 
e Cables and Connectors 
e GPIO and Prototyping 


e Cameras 
e Power Options 


Partner and official reseller for top Pi brands: 
he pe 
adafruit 4 Sparkfun 
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Price, service, sane. 
and logistics support 10 
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& PiShop.us 


APPROVED RESELLER 





Do you know 


HOW ROBOTS SEE? 





Buy in the USA: 


PiShop.us/stereopi 


Buy in Canada: 
BuyaPi.ca/stereopi 


LinuxGizmos.com 

“The StereoPi can capture, save, 
livestream, and process real-time 
stereoscopic video and images for 
robotics, AR/VR, computer vision, drone 
instrumentation, and panoramic video.” 





RASPBERRY Pl INSIDE 


MickMake 

“With it you can do things like, stream 
stereoscopic 3D video to YouTube, build 
real-time depth maps using OpenCV, 
create panoramics using Hugin and even 
a 3rd person view of real life. Cool.” 
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StereoPi is an open source stereoscopic 
camera, based on Raspberry Pi. 


This is the friendliest way to play with 
the stereoscopic vision for the spatially 
aware robots, 3D photo and video! 


Raspbian 


STOCK RASPBIAN OPEN SOURCE CROWDFUNDED 
SUPPORT PROJECT 


Raspberry Pi Blog Hackster News 

“There are some excellent “You can hook this up to YouTube, 
community efforts too, of to Oculus Go, you can use it with 
which our current OpenCvV.. | cannot wait to start 
favourite is this nifty dual messing around with these because 
camera board.” it’s basically a dream come true.” 
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